Use Jira Workflow Validators
Add a workflow validator when a transition must reject missing handoff data. This walkthrough targets the company-managed Diagram workflow editor with a Validators tab; other editor variants use different controls.
Step-by-step guide
Check access and scope
You need workflow administration access and a safe way to test the affected company-managed workflow. Identify all issue types sharing it before changing rules.
Choose the handoff transition
Choose the exact transition and required business data.
Open the workflow transition
In Space settings > Workflows, choose Edit workflow for the affected work types. Open the Diagram editor, select the target transition arrow and open Validators. Check every project sharing the workflow before editing.
- Worked example: Require a rollout evidence link before transition to Ready for release when that field is genuinely mandatory. Keep the error specific so the user knows how to correct the missing information.
Configure the validator
Choose Add validator, select Field Required Validator and select the rollout-evidence field. Set a specific error such as Add the rollout evidence link before release review, then save the validator. Ensure users can populate that field before or during the transition.
Test missing and valid data
On a test workflow or safe sample, attempt the transition with the field empty, then with evidence supplied. Confirm the error names the missing input and the valid attempt succeeds.
Publish with clear guidance
Publish deliberately and communicate the new handoff requirement.
Verify the result
The incomplete transition fails clearly while the valid transition succeeds with its evidence preserved.
Common mistakes
Check the handoff edge case
A vague failure message can trap users without explaining the missing requirement. State the field or evidence they must supply.
Sources and verification
Based on product documentation checked on 2026-10-24. This is a documentation-based guide, not a hands-on benchmark. Features and availability can change.