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

On this page:

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' — choose the Screen that is shown when an issue is being created.
  • 'Edit Issue' — choose the Screen that is shown when an issue is edited.
  • 'View Issue' — choose 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 an Issue Type Screen Scheme.

Configuring a Screen Scheme

  1. Log in as a user with the 'JIRA Administrators' global permission.
  2. Bring up the administration page by clicking either the 'Administration' link on the top bar or the title of the Administration box on the dashboard.
  3. Click the 'Issue Fields' sub-menu on the left hand side if it is not open already, and choose 'Screen Schemes' from the list.
  4. The 'View Screen Schemes' page will be displayed (see 'Managing Multiple Screen Schemes' below). Locate the Screen Scheme in which you are interested, and click the 'Screens' link next to it.
  5. You will be brought to the 'Configure Screen Scheme' page:

Associating an Issue Operation with a Screen

  1. The 'Add Issue Operation to Screen Association' is located at the bottom of the 'Configure Screen Scheme' page (see above).
  2. Select the Issue Operation with which you wish to associate a Screen.
  3. Select the desired Screen.
  4. Click the 'Add' button and the new association will be added to the list of associations.

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.

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 use the "Edit" link next to the Default entry to change the Screen that is associated with it.

Editing an Association

  1. On the 'Configure Screen Scheme' page, click the 'Edit' link next to the issue operation you wish to edit.
  2. You will be brought to the "Edit Screen Scheme Item" page.
  3. Select the screen you wish to change the association to.
  4. Click the 'Update' button and you will be returned to the screen scheme page.

Deleting an Association

  1. On the 'Configure Screen Scheme' page, click the 'Delete' link next to the issue operation you wish to remove.
  2. The association will be automatically removed from the list.

Managing Multiple Screen Schemes

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

  1. Log in as a user with the 'JIRA Administrators' global permission.
  2. Bring up the administration page by clicking either the 'Administration' link on the top bar or the title of the Administration box on the dashboard.
  3. Click the 'Issue Fields' sub-menu on the left hand side if it is not open already, and choose 'Screen Schemes' from the list.
  4. This will bring you to the 'View Screen Schemes' page.

Adding a Screen Scheme

  1. The 'Add Screen Scheme' form is located at the bottom of the 'View Screen Schemes' page.
  2. Enter the name of the new field screen.
  3. You can optionally add a description of the field screen.
  4. Select a default field screen. The default screen will be used for views that do not have an association.
  5. Click the 'Add' button. The screen will automatically update the field screen schemes list with the new field screen scheme.

Editing a Screen Scheme's details

  1. On the 'View Screen Schemes' page, click the 'Edit' link next to the selected Screen Scheme.
  2. 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.
  3. Click the 'Update' button.
  4. You will be brought back to the Screen Schemes page with your updates now applied to the Screen Schemes list.

Deleting a Screen Scheme

  1. On the 'View Screen Schemes' page, click the 'Delete' link next to the Screen Scheme you wish to delete.
  2. Click the 'Delete' button to confirm this action.
  3. You will be brought back to the Screen Schemes page with the Screen Scheme removed from the screen schemes list.

Screen Schemes that are associated with an Issue Type Screen Scheme cannot be deleted.

Copying a Screen Scheme

  1. On the 'View Screen Schemes' page, click the 'Copy' link next to the Screen Screen you wish to copy.
  2. You will now be directed to the "Copy Screen Scheme" page.
  3. Enter the name and description of the new Screen Scheme.
  4. Click the 'Copy' button.
  5. You will be brought back to the Screen Schemes page, and the newly added Screen Scheme will have the same settings as the original Screen Scheme.

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'.



Log a request with our support team.



Raise an issue for our developers.



See answers from the community.



Tweet, blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.