Setup Conditions and Validators
How to setup Jira workflow conditions and validators
Last updated
How to setup Jira workflow conditions and validators
Last updated
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.
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.
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
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.
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
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.