The Adaptavist Group LogoDocumentation

JQL Query Matches Condition

Use the JQL Query Matches Condition to control if an issue can be transitioned based on if a JQL query would return the current issue.

For example:

  • If you want the transition to be allowed when the current issue is using the Task issue type, you would use the JQL query: issuetype = "Task"
  • If you want the transition to be allowed when the current issue has a Priority of Medium or higher, you would use the JQL query: priority >= Medium

Use this condition

You can add this condition to any transition except the Create transition.

  1. Go to Administration → Issues → Workflows.
  2. Select Edit on the workflow you want to add a condition to.
  3. Select the transition to which you wish to add a condition.
  4. Under Options, select Conditions.
  5. On the Transition page, select Add condition.
  6. Select JQL query matches condition.
  7. Optional: Enter a note that describes the condition.
  8. Enter your JQL Query.
  9. Optional: Enter a preview issue key and select Preview.

    See the example below for more details.

  10. Select Update.
  11. Select Publish and choose if you want to save a backup copy of the workflow.

Testing your JQL

You can use the Preview feature within the workflow condition to test your JQL query against a specific issue.

  1. Edit or create a new JQL query matches condition.
  2. Enter your JQL Query.
  3. Enter the key for an issue you want to test with into Preview Issue Key.
  4. Click Preview.
Note: This conditions JQL is efficient; for example if the query you enter would typically return millions of issues, it will be modified to something like the following:
{issue = 15130} AND {issuetype = "Task"}

Search documentation

Start typing to search the docs.