Workflow Building Blocks for Jira
  • About Workflow Building Blocks for Jira
  • Administrator Guide
    • Setup Conditions and Validators
  • Conditions & Validators
    • 🚀 Ultimate Condition & Validator
    • Linked Issues Condition & Validator
    • Dates Compare Condition & Validator
    • Fields Required Condition & Validator
    • Jira Expression Condition & Validator
  • Writing Jira Expressions
    • Introduction to Jira Expressions
    • Jira expressions library
    • Writing validation messages
  • Testing & Debugging
    • Testing Conditions & Validators
    • Limitiations
  • Support
    • Service Desk
  • Atlassian Marketplace Apps
    • Workflow Building Blocks for Jira
    • Translated Fields for Jira & JSM
    • Field Rules - UI Modifications for Jira
Powered by GitBook
On this page
  • Jira Workflow Condition vs Validator
  • How Jira workflow validators work
  • How to add a validator?
  • How Jira workflow conditions work
  • How to add a condition?
  • New workflow editor vs old editor
  1. Administrator Guide

Setup Conditions and Validators

How to setup Jira workflow conditions and validators

PreviousAbout Workflow Building Blocks for JiraNext🚀 Ultimate Condition & Validator

Last updated 1 month ago

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?

  1. Edit the workflow that contains the transition.

  2. 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.

  3. Select the Validators tab and click on Add validator button

  4. Choose from the available validators and set any necessary parameters for the validator.

  5. Remember to Publish Draft

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?

  1. Edit the workflow that contains the transition.

  2. 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.

  3. Select the Conditions tab and click on Add condition button

  4. Choose from the available conditions, and set any necessary parameters for the condition

  5. Remember to Publish Draft

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.

Learn more about adding validators in

Learn more about adding conditions in

Atlassian's documentation
Atlassian's documentation
Validators available after installing Workflow Building Blocks for Jira app (WBB)
Conditions available after installing Workflow Building Blocks for Jira app (WBB)
In the list of available workflow validator, additional validators provided by the Workflow Building Blocks for Jira app will appear, including: Dates Compare Validator, Jira Expression Validator, Linked Issues Validator, Fields Required Validator and Ultimate Validator.
In the list of available workflow conditions, additional conditions provided by the Workflow Building Blocks for Jira app will appear, including: Dates Compare Condition, Jira Expression Condition, Linked Issues Condition, Fields Required Condition and Ultimate Condition.