Documentation For admins
Workflow validators Admin
Validators stop an issue from moving through a transition while checklist items are still open. The app provides two:
| Validator | Blocks the transition when… |
|---|---|
| Check that all items are complete | any item on any of the issue's checklists isn't Done |
| Check that all mandatory items are complete | any mandatory item isn't Done — optional items can stay open |
Add a validator to a transition
- Open the project's workflow in the workflow editor.
- Select the transition to guard — typically the one into Done.
- Add a validator and choose one of the two above.
- Save or publish the workflow.
Editing a company-managed workflow requires Jira administrator permission; in team-managed projects, project admins can edit the workflow.
What your team sees
When someone tries the transition with open items, Jira keeps the issue where it is and shows why, naming each checklist that still has open items:
Cannot transition because there are incomplete checklist items in: Definition of Done.
With the mandatory validator:
Cannot transition because there are incomplete MANDATORY items in: Definition of Done.
Mark the listed items Done and try again.
How items are evaluated
- Every checklist on the issue is checked, not just the first.
- In progress counts as open; only Done passes.
- An issue with no checklist items passes.
- If the app can't read the issue's checklists — during a service disruption, for example — the validator lets the transition through rather than blocking your team.