Screens group all available fields (or a subset of all available fields) defined in JIRA and organize them for presentation to a user. Through screens, you can control what fields are displayed to the user during issue operations (e.g. Create Issue and Edit Issue dialog boxes) or workflow transitions (e.g. Resolve Issue dialog box), as well as define the order in which these fields are shown to them. A screen also allows you to split subsets of fields across multiple tabs.

When it comes to field visibility, screens functionally overlap slightly with field configurations. For example, on the Create Issue dialog box, users will only see issue fields that:

Hence, a field may be present on a screen used by a project, but if that field is hidden in the field configuration used by the project, that field will not be visible to the user when that screen in the project is displayed.
(tick) If a particular field needs to be hidden at all times, it is easier to hide the field in the relevant field configuration than remove it from all screens. For more information please see the Overview.

On this page:

JIRA ships with the Default Screen, Resolve Issue Screen and Workflow Screen, which are used as described below:

Adding a screen

To add a new screen to JIRA:

  1. Log in as a user with the JIRA Administrators global permission.

  2. (tick) Keyboard shortcut: g + g + type screens



  3. Click the Add New Screen button to open the Add New Screen dialog box.
  4. Complete the Add New Screen dialog box:

Editing a screen's details

To change a screen's name and/or description:

  1. Log in as a user with the JIRA Administrators global permission.

  2. (tick) Keyboard shortcut: g + g + type screens
  3. Click the Edit link next to the appropriate screen.
  4. You will now be directed to the Edit Screen page where you can edit the name and/or description of the Screen.

Copying a screen

  1. Log in as a user with the JIRA Administrators  global permission.

  2. (tick)Keyboard shortcut: g + g + type screens
  3. Click the Copy link next to the Screen you wish to copy. You will be directed to the Copy Screen page, where you can enter a name and a description for the new Screen:

Deleting a screen

  1. Log in as a user with the JIRA Administrators global permission.

  2. (tick) Keyboard shortcut: g + g + type screens
  3. Click the Delete link next to the screen you wish to delete. You will be prompted to confirm your deletion

(info) Screens that are associated with one or more screen schemes, or one or more workflow transitions, cannot be deleted.

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.

To configure a screen's tabs and fields:

  1. Log in as a user with the JIRA Administrators global permission.

  2. (tick) Keyboard shortcut: g + g + type screens
  3. Click the Configure link (under the Operations column) next to the screen you want to add a field to, to open the Configure Screen page for that screen.



    OperationInstructions
    Add a tabClick Add Tab. Enter the name of the new tab in the dialog that appears and clickAdd.
    Move a tabHover over the dotted part of the tab (next to the tab name) and drag the tab to the desired position.
    Rename a tab1. Hover over the tab name and click the pencil icon.
    2. Enter the new name and click OK.
    Delete a tabHover over the tab name and click the X.
    Add a field1. Click the tab that you want to add the field to.
    2. Type the name of the field in the dropdown 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 fieldHover 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 fieldHover over the field and click the Delete button that appears.

Tips on configuring screens

Activating a screen

To make a Screen available to users, you can either: