Defining a screen

As a Jira administrator, you can use screens to group all available Jira application fields and control which fields are displayed to your team at different stages of your workflow (like when creating, editing, or resolving an issue).

The information on this page doesn't apply to the new issue view (currently for Jira Core boards and Jira Software boards and backlogs), which uses the View issue screen configuration to determine which fields to show. To add or remove fields, head to Project settings > Screens, expand the appropriate screen scheme, and select the "View issue" screen to configure it. Field order isn't configurable in the new issue view just yet.

In order for your users to see the right fields at the right time, you'll want to review your field configurations and project permissions to ensure that: 

Jira applications ship with the Default, Resolve Issue, and Workflow Screens: 

  • The Default Screen is used for the default issue operations for creating, editing or viewing an issue.
  • The Resolve Issue Screen is used for the transition view for the default Close Issue and Resolve Issue transitions, originating from the Open, In Progress and Reopened steps in Jira's default workflow.
  • The Workflow Screen is used for the transition view for the default Reopen Issue transitions, originating from the Resolved and Closed steps and Close Issue transition, originating from the Resolved step in Jira's default workflow. The Workflow Screen defines a smaller set of fields than the Resolve Issue Screen.

Adding a screen

  1. Select the Jira icon (, or ) > Jira settings > Issues.
  2. Click Screens > Add screen.
  3. Add a name and description that describes when this screen should be used. 

Editing a screen's details

  1. Select the Jira icon (, or ) > Jira settings > Issues.
  2. Click Screens
  3. Next to the relevant screen, click Edit to update the name or description.

Copying a screen

  1. Select the Jira icon (, or ) > Jira settings > Issues.
  2. Click Screens
  3. Next to the relevant screen, click Copy to enter a new screen name and description. 

Deleting a screen

Please note that screens associated with a screen scheme or workflow transition cannot be deleted. 

  1. Select the Jira icon (, or ) > Jira settings > Issues.
  2. Click Screens
  3. Next to the relevant screen, click Delete

Configuring a screen's tabs and fields

You can configure the fields that display on a particular screen by adding/removing fields, as well as reordering them. Tabs can also be used to help group related fields. Tabs are useful for organizing complex screens, as you can place less used fields onto separate tabs. You can also add, remove and reorder tabs, as well as rename them.

You can't view issue tabs in the new issue view just yet. Click the issue key to go to the full-page view (if you're not already there) then click through to the old issue view at the top-right to complete this process.


  1. Select the Jira icon (, or ) > Jira settings > Issues.
  2. Click Screens
  3. Next to the relevant field, click Configure to make the following changes: 

    What do you want to do? Steps
    Add a tab Click Add Tab. Enter the name of the new tab in the dialog that appears and clickAdd.
    Move a tab Hover over the dotted part of the tab (next to the tab name) and drag the tab to the desired position.
    Rename a tab 1. Hover over the tab name and click the pencil icon.
    2. Enter the new name and click OK.
    Delete a tab Hover over the tab name and click the X.
    Add a field 1. Click the tab that you want to add the field to.
    2. Type the name of the field in the drop-down displayed at the bottom of the current fields. Field suggestions will appear as you type.
    3. Click Add Field to add it to the current tab.
    Move a field Hover over the dotted part of the field (next to the field name) and drag the field to the desired position.
    Move a field to a different tab by dragging it to the name of the tab and dropping it.
    Delete a field Hover over the field and click Delete that appears.
tip/resting Created with Sketch.

Tips for configuring screens

Date fields on View Issue screen — Fields of type 'Date' will always be displayed in the 'Dates' area of the default 'View Issue' screen, regardless of how you reorder them. This applies even if the dates are custom fields.

System fields on View Issue screen — System fields on the default 'View Issue' screen (e.g. Summary, Security Level, Issue Type, etc.) are fixed. This means that they will always appear in the same place on the 'View Issue' screen, even if you configure the Screen to move them onto a separate tab. Custom fields of related to Dates and People will also appear in their fixed section of the view issue screen. If none of the fields on a tab contain data then the tab is not shown. To make a tab show up, make sure it has a custom field with a type such as Text or Select and that the field has a value.
Note, this information only applies to the screen associated with the 'View Issue' operation in a screen scheme.

Time tracking — You can add the ability to log time and/or specify/modify time estimates to a screen by adding the special Log time and/or Time Tracking fields respectively.

  • If these fields cannot be found in the Add Field selection box and they haven't already been added to the screen, check whether Jira's Time Tracking feature has been enabled. These fields won't be available to add to any screen if Time Tracking is disabled.

  • If any screens have the Log time or Time Tracking fields and Jira's Time Tracking feature is subsequently deactivated, those screens will retain these fields until you specifically remove them. However, the fields won't be visible to the user until Time Tracking is reactivated.

Renaming standard Jira fields — You can't rename the standard Jira fields (like Priority and Summary).

Activating a screen

There are two ways to make a screen available to other users:

  1. Associate the screen with an issue operation (e.g. "Create Issue") within a screen scheme. See Associating screens with an issue operation to learn more. 
  2. Associate the screen with a workflow transition (e.g. "Start progress"). See Working with workflows to learn more.
Last modified on Jul 2, 2018

Was this helpful?

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