# Workflows Troubleshooting * If a workflow doesn’t appear to work, first check whether the trigger, condition, or action is scoped too narrowly. * Review your organization selection. If you’re in a demo org or test space, workflows may not behave as expected. * Developers often miss that some options (like PR type) depend on full repo indexing. Make sure you've selected all relevant repositories. * When defining conditions like "maximum number of admins," remember that this is just a default. You can override the value if your security policy is stricter. * Use Slack and email actions in tandem when urgency is high. If you're on vacation, a Slack alert can still reach you. * Hover over any term or field in the workflow builder for a tooltip explanation. These hints clarify field usage and help identify less obvious logic. * If you expect certain applications or issues to trigger a workflow and nothing happens, verify the inputs and filters one by one. Misconfigurations often hide in small toggles like repo selection or visibility filters. ## Edge Case Scenarios * **Naming Conflicts**: If your production app is called "test-app" and filtered out due to its name, adjust the inclusion/exclusion logic to reflect reality. * **False Priority Downgrades**: If a policy marks something as low severity but you know it’s exposed to the internet, you can increase its business priority to elevate its urgency in workflows. * **Timeout Behavior**: Customers requested visual feedback during long workflow executions. If you’re unsure whether a workflow completed, recheck your application scope or toggle options to refresh visibility. ## What to Do When a Workflow Doesn’t Work * Check if the repository or application is actually selected and visible. * Confirm that the issue matches all trigger and condition requirements. * Review whether pipeline-specific actions (like "Block pipeline") are used in a regular scan workflow, these won't trigger outside pipeline context. * Verify that your organization context is correct. If you're in a demo org, workflows may not behave as expected. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.ox.security/automate-with-ox-workflows/ox-automations/workflows-troubleshooting.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.