Associating a screen with an issue operation

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

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.

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:

Managing screen schemes 

For all of the following procedures, you must be logged in as a user with the Jira administrators global permission.

Add 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. In the upper-right corner of the screen, select Administration  > Issues.

  2. In the sidebar, select Screens and go to Screen schemes to open the View screen schemes page.
  3. Select 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.

Edit a screen scheme's details

  1. In the upper-right corner of the screen, select Administration  > Issues.
  2. In the sidebar, select Screens and go to Screen schemes to open the View screen schemes page.
  3. Select 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.

Delete 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. In the upper-right corner of the screen, select Administration  > Issues.
  2. In the sidebar, select Screens and go to Screen schemes to open the View screen schemes page.
  3. Select the Delete link next to the desired screen scheme. You will be prompted to confirm your deletion.

Copy a screen scheme

  1. In the upper-right corner of the screen, select Administration  > Issues.
  2. In the sidebar, select Screens and go to Screen schemes to open the View screen schemes page.
  3. Select 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.

Configure a screen scheme

Associate a screen with an issue operation

  1. In the upper-right corner of the screen, select Administration  > Issues.
  2. In the sidebar, select Screens and go to Screen schemes to open the View screen schemes page:

    List of screen schemes.
  3. Locate the screen scheme in which you are interested, and select the Configure link next to it.
  4. Select 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.

Edit an association

  1. In the upper-right corner of the screen, select Administration  > Issues.
  2. In the sidebar, select Screens and go to Screen schemes to open the View screen schemes page.
  3. Locate the screen scheme in which you are interested, and select the Configure link next to it. The Configure screen scheme page is  displayed.
  4. Select Edit next to the issue operation you wish to edit. The Edit screen scheme Item page is  displayed.
  5. Select the desired screen and select Update.

Deleting an association

  1. In the upper-right corner of the screen, select Administration  > Issues.
  2. In the sidebar, select Screens and go to 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. Select the Delete link next to the issue operation you wish to remove.

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

Last modified on Oct 10, 2022

Was this helpful?

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