Setup Conditions and Validators
How to setup Jira workflow conditions and validators
Jira Workflow Condition vs Validator
What’s the Difference?
Workflow condition: Prevents users from seeing or executing a transition unless the required conditions are met. If the condition is not satisfied, the transition button won’t even appear.
Workflow validator: Allows the transition button to be clicked, but blocks the transition after submission if the criteria aren’t met.
In short: Conditions hide transitions, while Validators block them after submission.
How Jira workflow validators work
Validators are executed when someone tries to transition an issue. A validator makes sure details are correct when transitioning an issue, and stops the transition if they aren’t. When there are incorrect details, the person transitioning the issue will be prompted to fix them.
How to add a validator?
Edit the workflow that contains the transition.
In diagram mode, select the transition arrow and click Validators in the properties panel. or In text mode, select the transition's name from the Transitions (id) column.
Select the Validators tab and click on Add validator button
Choose from the available validators and set any necessary parameters for the validator.
Remember to Publish Draft
Learn more about adding validators in Atlassian's documentation
How Jira workflow conditions work
Conditions control whether the user can execute a transition. If a condition fails, the user won't be able to execute the transition. For example, the user won't see the transition button on the View issue page.
How to add a condition?
Edit the workflow that contains the transition.
In diagram mode, select the transition arrow and click Conditions in the properties panel. or In text mode, select the transition's name from the Transitions (id) column.
Select the Conditions tab and click on Add condition button
Choose from the available conditions, and set any necessary parameters for the condition
Remember to Publish Draft
Learn more about adding conditions in Atlassian's documentation
New workflow editor vs old editor
Recently, in Jira, you may have noticed the new workflow editor, which introduces new terminology. To add conditions and validators, first add a "Rule," then select the appropriate rule type, which can be mapped as follows:
Conditions → Restrict transition
Validators → Validate details
Post-functions → Perform actions
If the new editor does not yet support third-party apps in your Jira instance, you can switch back to the old editor.
Last updated