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

Platform Notice: Cloud Only - This article only applies to Atlassian apps 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.

Solution

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 ⚙️Settings > Issues

  2. Navigate to Screens

  3. Select AddScreen 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, selectValidators

  6. Select Add validator

  7. Choose the Field Required Validatoroption 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

Updated on October 28, 2025

Still need help?

The Atlassian Community is here for you.