On this page:

Validators for Jira workflow transitions for Checklists for Atlassian cloud

This page shows you how to set up a validator in a Jira workflow. The validator acts after a user attempts to transition an issue. If the checklist(s) are not complete, the validator rejects the status change and prevents the issue from transitioning to the target status. If you would like to hide the status entirely, try using a condition and checking to see if the “Didit checklist completed” field has a certain value.

You must have Jira admin permission in order to add a validator to a Jira workflow. If you do not have Jira admin permission, request assistance from the Jira admin of your instance. Please keep in mind the general best practices when editing Jira workflows. This workflow could be shared with other projects, try to be aware of how many projects you are changing.

If you have multiple checklists attached to an issue, this validator will ensure all checklists are completed.

  1. ac-image
    ac-image
  2. Go to the “Workflows” on the left side and click the pencil icon to edit the workflow.

    ac-image
    ac-image
  3. In the diagram view, click the transition you would like to add the validator to.

    ac-image
    ac-image
  4. Select “Validators” from the options.

    ac-image
    ac-image
  5. Click “Add validator.”

    ac-image
    ac-image
  6. Choose the validator “The connected checklist is completed - Checklists for Jira” from the list.

    ac-image
    ac-image
  7. Create the validator by clicking “Add” again.

    ac-image
    ac-image
  8. Publish the draft to apply the changes and make them effective. If you think you may want to revert the change, you can always save a backup copy.

    ac-image
    ac-image
  9. If a user tries to transition an issue in your project to the designated status but the checklist is not complete, this error will show.

    ac-image
    ac-image

You can use this same method for any status and any transition in a company managed project.

Short link to this page: https://seibert.biz/checklistsjiraworkflowvalidatorsÂ