Require field edit when transitioning the status of a Jira work item

Platform Notice: Cloud - This article applies to Atlassian products on the cloud platform.

Summary

When a field is required before a status transition, users may not be prompted to edit the field.

We can display a screen with the required field during the work item transition so the user can assign a value and the workflow continues successfully. 

Use a transition screen with a workflow validator to require field edits

Within a workflow transition, we'll set a validation where a field must have a value before changing from Status A to Status B. Now whenever you try to transition to the status, a warning message shows up in the UI:

"Transition failed. Field <your_field> is required."


warning message in jira user interface. the warning states a transition has failed and what field is required to proceed with the transition.

Create a unique screen for the specific work item transition

  1. Navigate to gear Settings > Issues
  2. Navigate to Screens
  3. Select Add Screen and choose a memorable name and optional description
  4. Search for the newly created screen and select it
  5. Add your required field to the newly created screen

Add a validator to your affected project workflow

  1. Navigate to your project
  2. Select Project Settings > Workflows
  3. Choose the workflow you want to edit, and select Edit (pencil icon)
  4. Select the arrow between the affected statuses (this is the transition)
    example of workflow editor. the transition arrow is highlighted.
  5. In the Transition editor window, select Validators
  6. Select Add validator
  7. Choose the Field Required Validator option and select Add
  8. Choose your required field, and select Add
  9. In the transition editor, select Edit
    transition editor screen. the edit button is highlighted with a blue arrow.
  10. In the transition view field, select the screen that was created
  11. Select Update
  12. Publish the new workflow version by selecting Publish Draft at the top of the page
Last modified on Mar 18, 2025

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.