Associating a screen with an issue operation

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.

In a screen scheme, you can specify the same screen (or choose different screens) for these issue operations. Once you have created your screen scheme, you will need to activate it by associating the screen scheme with issue types via an 'issue type screen scheme'. (In turn, issue type screen schemes are associated with JIRA projects.)

(info) Please be aware that although it is possible to associate any screen defined in your JIRA installation with either a screen scheme or a workflow transition view, screen schemes and workflow transition views are distinct and unrelated.

On this page:

Note: For all of the following procedures, you must be logged in as a user with the JIRA Administrators global permission.

Adding a screen scheme

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

  1. Choose > Issues
  2. Select Screens > Screen Schemes to open the View Screen Schemes page.
  3. Click the Add New Screen Scheme button.
  4. Fill out the details for the new screen scheme on the form that is displayed.

Note: The default screen is used for issue operations that do not have a screen associated with them.

Editing a screen scheme's details

  1. Choose > Issues
  2. Select Screens > Screen Schemes to open the View Screen Schemes page.
  3. Click Edit next to the desired screen scheme.
  4. 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.

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.

  1. Choose > Issues
  2. Select Screens > Screen Schemes to open the View Screen Schemes page.
  3. Click the Delete link next to the desired screen scheme. You will be prompted to confirm your deletion.

Copying a screen scheme

  1. Choose > Issues
  2. Select Screens > Screen Schemes to open the View Screen Schemes page.
  3. Click Copy next to the screen scheme you wish to copy.
  4. 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.

Configuring a screen scheme

Associating a screen with an issue operation

  1. Choose > Issues
  2. Select Screens > Screen Schemes to open the View Screen Schemes page:

  3. Locate the screen scheme in which you are interested, and click the Configure link next to it.
  4. Click Associate an Issue Operation with a Screen, and select the following options: 
    1. Select the Issue Operation with which you wish to associate a screen.

    2. Select the desired screen.

Important notes

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

  2. 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. Click Edit next to the Default entry to change the screen that is associated with it.

  3. The View Issue operation only allows you to control the layout of custom fields in the middle of the View Issue page. It ignores all the non-custom fields on the screen.

Editing an association

  1. Choose > Issues
  2. Select Screens > Screen Schemes to open the View Screen Schemes page.
  3. Locate the screen scheme in which you are interested, and click the Configure link next to it. The Configure Screen Scheme page is  displayed.
  4. Click Edit next to the issue operation you wish to edit. The Edit Screen Scheme Item page is  displayed.
  5. Select the desired screen and click Update.

Deleting an association

  1. Choose > Issues
  2. Select Screens > Screen Schemes to open the View Screen Schemes page.
  3. Locate the screen scheme in which you are interested, and click the Configure link next to it. The Configure Screen Scheme page is displayed.
  4. Click the Delete link next to the issue operation you wish to remove.

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.

  1. Configure an issue type screen scheme to use the screen scheme.
  2. Associate the issue type screen scheme with a project.

For details of both procedures, see Associating screen and issue operation mappings with an issue type.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport