Add Custom Fields to Workflow Transition in Jira Data Center

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

This article does not describe how to make any field from the transition screen mandatory.

If you are looking for a way to make any field mandatory on the transition screen, please refer to Make custom fields required in a workflow transition in Jira Data Center.

This article walks you through the steps of how to add a screen to a workflow transition and how to include custom fields in this screen.

Environment

Jira Data Center on any version from 8.0.0.

Solution

Scenario

We will use the following example:

A custom field name, Resolve Method, has been created. Now we will have to create a new screen name, Resolution screen, and map the resolution screen to the Resolve Issue Transition.

Apply the steps to other Workflow transitions, Screens, and (Custom) Fields by exchanging the names.

Create a Screen and Add the Custom Field to the Screen

  1. Log in as a user with Jira Administrator permission.

  2. Navigate to Administration ⚙ , select Issues.

  3. Click on Screens and click Add Screen.

  4. Enter the Name and the Description of the Screen, then Add.

  5. You can check that you are now on the Configure Screen page, or you can go to the page by using the Configure link at the bottom, where all the screens are listed.

  6. Add the custom field created (Resolve Method ) to the screen.

    Configure Screen page: on the Field Tab use the drop-down to look for the field to add, in this case Resolve Method, by starting to type the name

Mapping a Screen to a Workflow Transition

  1. Navigate to Administration ⚙, select Issues, and click on Workflows.

  2. Click on the Edit link for the workflow that you would like to add the transition screen to.

  3. Click on the Resolve Issue Transition, then select Edit in the pop-up window.

    Example Workflow Diagram with the Resolve Issue Transition selected. The details for the transition are displayed in a pop-up window to the right of the screen
  4. At the Edit Transition window, select Resolution Screen for the screen, then Save.

    Edit Transition pop-up window. Drop-Down dialog for the Screen, where you search and select for your screen
  5. If it's an Active Workflow, remember to Publish Draft after you have done editing.

  6. Otherwise, you will need to map the workflow to a workflow scheme and then associate the workflow scheme with a project to activate the workflow.

Result

When you resolve an Issue, the Resolution Screen will pop up. On the transition screen, you can specify the Resolve Method.

Example of the Resolve Issue screen, displaying the fields Resolve Method, Resolution and Comment

Updated on May 9, 2025

Still need help?

The Atlassian Community is here for you.