How to add a screen with custom fields to a 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

Note that this knowledge 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 the knowledge article Make custom fields required in a workflow transition in Jira server.

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

Scenario

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 Resolve Issue Transition.

Environment

Jira Data Center on any version from 8.0.0.

Solution

Create a Screen and Add the Custom Field into the Screen

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

  2. Click at the cog icon ⚙ > Select Issues > Find Screens under Screens category at the left.

  3. Click Add Screen.

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

  5. After that you will redirect to the Configure Screen page or you can go to the page by using the Configure link at the page where all the screens are listed.

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

    (Auto-migrated image: description temporarily unavailable)

Mapping a Screen to a Workflow Transition

  • Go to Workflows page : Cog Icon ⚙ > Issues > Find Workflows under Workflows category at the left.

  • Click at the Edit link at the workflow that you would like to add the transition screen in.

  • Click at the Resolve Issue Transition then select Edit at the pop up windows.

  • (Auto-migrated image: description temporarily unavailable)
  • At the Edit Transition window select Resolution Screen for screen then Save.

  • (Auto-migrated image: description temporarily unavailable)
  • If it's an Active Workflow, remember to Publish Draft after you have done editing.

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

  • When you Resolve Issue, the Resolution Screen will prompt out. Then you can specify the Resolve Method on the transition screen.

  • (Auto-migrated image: description temporarily unavailable)
Updated on April 8, 2025

Still need help?

The Atlassian Community is here for you.