Associating screen and issue operation mappings with an issue type

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

What is an "issue type screen scheme"?

An "issue type screen scheme" associates a screen scheme (which defines mappings between screens and issue operations) with issue types. Hence, an issue type screen scheme allows you to specify different screens for different issue types when used for the same issue operation (e.g. 'Create Issue') in a given Jira project. For more information, please see the overview diagram.

By default, your Jira system contains an issue type screen scheme that's called a default issue type screen scheme. You may want to edit this scheme or copy it to make a new one.

Configuring issue type screen schemes

The configuration of an issue type screen scheme involves associating an issue type(s) with a particular screen scheme. For example, associating the 'Bug' issue type with the 'Default Screen Scheme', and then associating the 'Improvement' issue type with the 'Improvement Screen Scheme'.

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

On this page:

Associate an issue type with a screen scheme

  1. In the upper-right corner of the screen, select Administration  > Issues.

  2. In the sidebar, select Screens and go to Issue type screen schemes to open the View issue type screen schemes page.
  3. Select the Configure link next to the desired issue type screen scheme.
  4. Select Associate an issue type with a screen scheme and select the following options: 
    1. Select an Issue type you wish to associate a screen scheme with.
    2. Select the desired Screen scheme.
  5. Select the Add button and the new association will be added to the association list above.

Note that:

  • There can only be one association for each issue type. If all issue types have been associated with a screen scheme, you can use the Edit link next to each entry to change the screen scheme that is associated with it.
  • If there is no specific entry for an issue type, the screen scheme associated with the Default entry will be used.

Edit an association with a screen scheme

  1. In the upper-right corner of the screen, select Administration  > Issues.
  2. In the sidebar, select Screens and go to Issue type screen schemes to open the View issue type screen schemes page.
  3. Select the Configure link next to the desired issue type screen scheme, which opens the Configure issue type screen scheme page (see above).
  4. Select the Edit link next to the issue type you wish to edit, which displays the Edit issue type screen scheme entry page.
  5. Select the screen whose association you wish to change, and select the Update button.

Delete an association with a screen scheme

  1. In the upper-right corner of the screen, select Administration  > Issues.
  2. In the sidebar, select Screens and go to Issue type screen schemes to open the View issue type screen schemes page.
  3. Select the Configure link next to the desired issue type screen scheme, which opens the Configure issue type screen scheme page (see above).
  4. Select the Delete link next to the issue operation you wish to remove.

The Default entry is used for all issue types that do not have a specific entry in the scheme. It cannot be deleted.

Add an issue type screen scheme

  1. In the upper-right corner of the screen, select Administration  > Issues.
  2. In the sidebar, select Screens and go to Issue type screen schemes to open the View issue type screen schemes page.
  3. Select the Add Issue Type Screen Scheme button.
  4. Enter the name for the new scheme. You can optionally add a description.
  5. Select a screen scheme for the Default entry in the new scheme. The Default entry will be used for issue types that do not have a specific mapping in the scheme.
  6. Select the Add button. The screen will automatically update the Issue Type Screen Schemes list with the new issue type screen scheme.

Edit an issue type screen scheme

  1. In the upper-right corner of the screen, select Administration  > Issues.
  2. In the sidebar, select Screens and go to Issue type screen schemes to open the View issue type screen schemes page.
  3. Select the Edit link next to the desired issue type screen scheme to open the Edit Issue Type Screen Scheme page, where you can edit the issue type screen scheme's name and description, as well as the screen scheme of the Default entry.
  4. Select the Update button, which returns you to the View Issue Type Screen Schemes page, with your updates now applied to the Issue Type Screen Schemes list.

Delete an issue type screen scheme

  1. In the upper-right corner of the screen, select Administration  > Issues.
  2. In the sidebar, select Screens and go to Issue type screen schemes to open the View issue type screen schemes page.
  3. Select the Delete link next to the issue type screen scheme you wish to delete.

Issue type screen schemes that are associated with a project cannot be deleted.

Copy an issue type screen scheme

  1. In the upper-right corner of the screen, select Administration  > Issues.
  2. In the sidebar, select Screens and go to Issue type screen schemes to open the View issue type screen schemes page.
  3. Select the Copy link next to the field screen you wish to copy, which opens the Copy Issue Type Screen Scheme page.
  4. Enter the name and description of the new issue type screen scheme, and click the Copy button.

Associate an issue type screen scheme with a project

Once you have created and configured an issue type screen scheme to your desired settings, you can now associate the scheme with a project. This will apply your chosen screen scheme to each issue type within the selected project.

  1. In the upper-right corner of the screen, select Administration  > Projects.
  2. Select a project's name to open it.
  3. In the sidebar, select Screens.
  4. Select the Actions dropdowт, and choose Use a different scheme:
  5. Select the screen scheme you wish to associate with this project.
  6. Select the Associate button.

To control which issue types apply to a project, see Associating issue types with projects.

Last modified on Oct 10, 2022

Was this helpful?

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