Documentation for JIRA 4.4. Documentation for other versions of JIRA is available too.

Skip to end of metadata
Go to start of metadata

What is a 'Screen Scheme'?

A Screen Scheme allows you to choose which Screen will be shown to a JIRA user when they perform a particular issue operation. There are three issue operations for which you can choose a Screen:

  • 'Create Issue' — the Screen that is shown when an issue is being created.
  • 'Edit Issue' — the Screen that is shown when an issue is edited.
  • 'View Issue' — the Screen that is shown when a user views an issue.

You can specify the same screen for each of these issue operations, or choose different screens for each operation.

(info) Once you have created your Screen Scheme, you will need to activate it by associating it with a project and issue types via an Issue Type Screen Scheme.

On this page:

Configuring a Screen Scheme

Associating a Screen with an Issue Operation

  1. Log in as a user with the 'JIRA Administrators' global permission.
  2. Select 'Administration' > 'Issues' > 'Screens' > 'Screen Schemes'.
    (tick) Keyboard shortcut: 'g' + 'g' + type 'sc'
  3. The 'View Screen Schemes' page will be displayed:

    Screenshot 1: the 'View Screen Schemes' page
  4. Locate the Screen Scheme in which you are interested, and click the 'Configure' link next to it. The 'Configure Screen Scheme' page will be displayed:

    Screenshot 2: the 'View Screen Schemes' page
  5. The 'Add Issue Operation to Screen Association' is located at the bottom of the 'Configure Screen Scheme' page.
    • Select the Issue Operation with which you wish to associate a Screen.
    • Select the desired Screen.

(info) Note:

  • There can only be one association for an issue operation per Screen Scheme. If all operations have been associated with a Screen, use the 'Edit' link next to each operation to change the Screen it is associated with.
  • If an issue operation does not have a specific mapping to a Screen, the screen that is associated with the Default entry will be used for that operation. The Default entry cannot be deleted from a Screen Scheme. You can click the "Edit" link next to the Default entry to change the Screen that is associated with it.
  • The 'View Issue' operation only allows you to control the layout of custom fields in the middle of the 'View Issue' page. The 'View Issue' page ignores all the non-custom fields on the Screen.

Editing an Association

  1. Log in as a user with the 'JIRA Administrators' global permission.
  2. Select 'Administration' > 'Issues' > 'Screens' > 'Screen Schemes'.
  3. The 'View_Screen_Schemes' page will be displayed (see above).
  4. Locate the Screen Scheme in which you are interested, and click the 'Configure*' link next to it. The 'Configure_Screen_Scheme' page will be displayed (see above).
  5. On the 'Configure Screen Scheme' page, click the 'Edit' link next to the issue operation you wish to edit. The 'Edit Screen Scheme Item' page will be displayed:

    Screenshot 3: the 'Edit Screen Scheme Item' page
  6. Select the desired screen and click 'Update'.

Deleting an Association

  1. Log in as a user with the 'JIRA Administrators' global permission.
  2. Select 'Administration' > 'Issues' > 'Screens' > 'Screen Schemes'.
  3. The 'View_Screen_Schemes' page will be displayed (see above).
  4. Locate the Screen Scheme in which you are interested, and click the 'Configure*' link next to it. The 'Configure_Screen_Scheme' page will be displayed (see above).
  5. On the 'Configure Screen Scheme' page, click the 'Delete' link next to the issue operation you wish to remove.

Adding a Screen Scheme

Depending on your requirements, you may want to create multiple Screen Schemes, and associate them with different projects/issue types.

To create a new screen scheme,

  1. Select 'Administration' > 'Issues' > 'Screens' > 'Screen Schemes'.
    (tick) Keyboard shortcut: 'g' + 'g' + type 'sc'
  2. The 'View_Screen_Schemes' page will be displayed (see above).
  3. The 'Add Screen Scheme' form is located at the bottom of the 'View Screen Schemes' page. Enter the name of the new field screen and select a default screen. The default screen will be used for issue operations that do not have a screen associated with them.

Editing a Screen Scheme's details

To change a screen scheme's name, description or default screen,

  1. Select 'Administration' > 'Issues' > 'Screens' > 'Screen Schemes'.
  2. The 'View_Screen_Schemes' page will be displayed (see above). Click the 'Edit' link next to the desired Screen Scheme.
  3. You will now be directed to the 'Edit Screen Scheme' page where you can edit the Screen Scheme's name and description and the Screen that is associated with the Default Entry of the scheme.

    Screenshot 4: the 'Edit Screen Scheme' page

Deleting a Screen Scheme

Note that Screen Schemes that are associated with an Issue Type Screen Scheme cannot be deleted. You will first need to edit the Issue Type Screen Scheme and remove the Screen Scheme.

To delete a screen scheme,

  1. Select 'Administration' > 'Issues' > 'Screens' > 'Screen Schemes'.
  2. The 'View_Screen_Schemes' page will be displayed (see above). Click the 'Delete' link next to the desired Screen Scheme. You will be prompted to confirm your deletion.
    Screenshot 5: the 'Delete Screen Scheme' page

Copying a Screen Scheme

  1. Select 'Administration' > 'Issues' > 'Screens' > 'Screen Schemes'.
  2. The 'View_Screen_Schemes' page will be displayed (see above). Click the 'Copy' link next to the Screen Scheme you wish to copy
  3. You will now be directed to the 'Copy Screen Scheme' page. Enter the name and description of the new Screen Scheme and click the 'Copy' button.
    Screenshot 6: the 'Copy Screen Scheme' page

Activating a Screen Scheme

To activate a Screen Scheme, you need to associate it with one or more projects and issue types, using Issue Type Screen Schemes. To activate a Screen Scheme,

  1. configure an Issue Type Screen Scheme to use the Screen Scheme; then
  2. associate the Issue Type Screen Scheme with a project.

For details of both procedures, see 'Associating screens with Issue Types'.