Checklist validation
- Monika Mo Kaczkowska
- Anna Kwaśny
- Kamil Parzyjagła
Please bear in mind that this feature is not available for team-managed projects in Jira Cloud.
You can set Multiple Checklists for Jira to enforce that certain conditions are met before a status transition is allowed. For example, you can make sure that all items have been checked off or that all items have a status set. It can be done by Jira’s global administrator.
It’s configured by editing the workflow. To do it, access the Workflow settings from Jira or project settings.
Click on the edit actions button next to the workflow you want to modify. Then, choose the transition you want to add a validator to and click Validators.
Next, click Add validator, select ‘All checklist items are checked’, and click Add.
Then specify which checklist will be considered by this validator by providing the checklist’s name or leave empty to apply to all checklists.
You can also select our second validator: ‘All checklist items have status set’, and click Add.
Similarly to the previous validator provide the name of the checklist or leave it empty if you want the validator to work for all checklists in the issue.
The final step is to click Publish Draft to make your workflow with a validator active.
From now on, the transition will require that all checklist items are checked. An error message will be displayed informing that all items in the checklist need to be completed before this operation is possible.
If checklists are disabled in the project or in the issue type, the validation will not be used.