Documentation for JIRA 6.3 EAP developer (EAP) releases only. Not using this? See below:
(JIRA 6.2.x documentation | JIRA OnDemand documentation | earlier versions of JIRA)

Skip to end of metadata
Go to start of metadata

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 issues 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 called Default Issue Type Screen Scheme. You may want to edit this scheme or copy it to make a new one.

Configuring an issue type screen scheme

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

Associating an issue type with a screen scheme

  1. Log in as a user with the JIRA Administrators global permission.
  2. Choose > Issues. Select Screens > Issue Type Screen Schemes to open the View Issue Type Screen Schemes page.
    (tick) Keyboard shortcut: g + g + start typing issue type screen schemes
  3. Click the Configure link next to the desired Issue Type Screen Scheme, which opens the Configure Issue Type Screen Scheme page:
  4. Click Associate an issue Type with a Screen Scheme, which displays this screen:
  5. Select an Issue Type you wish to associate a Screen Scheme with.
  6. Select the desired Screen Scheme.
  7. Click the Add button and the new association will be added to the association list above.

Please note

Icon
  • 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.

Editing an association

  1. Log in as a user with the JIRA Administrators global permission.
  2. Choose > Issues. Select Screens > Issue Type Screen Schemes to open the View Issue Type Screen Schemes page.
    (tick) Keyboard shortcut: 'g' + 'g' + start typing 'issue type screen schemes'
  3. Click the Configure link next to the desired Issue Type Screen Scheme, which opens the Configure Issue Type Screen Scheme page (see above).
  4. Click 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 click the Update button.

Deleting an association

  1. Log in as a user with the JIRA Administrators global permission.
  2. Choose > Issues. Select Screens > Issue Type Screen Schemes to open the View Issue Type Screen Schemes page.
    (tick) Keyboard shortcut: 'g' + 'g' + start typing 'issue type screen schemes'
  3. Click the Configure link next to the desired Issue Type Screen Scheme, which opens the Configure Issue Type Screen Scheme page (see above).
  4. Click the Delete link next to the issue operation you wish to remove.
Icon

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

Adding an issue type screen scheme

  1. Log in as a user with the JIRA Administrators global permission.
  2. Choose > Issues. Select Screens > Issue Type Screen Schemes to open the View Issue Type Screen Schemes page.
    (tick) Keyboard shortcut: 'g' + 'g' + start typing 'issue type screen schemes'
  3. Click the Add Issue Type Screen Scheme button to open this page:
  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. Click the Add button. The screen will automatically update the Issue Type Screen Schemes list with the new Issue Type Screen Scheme.

Editing an issue type screen scheme

  1. Log in as a user with the JIRA Administrators global permission.
  2. Choose > Issues. Select Screens > Issue Type Screen Schemes to open the View Issue Type Screen Schemes page.
    (tick) Keyboard shortcut: 'g' + 'g' + start typing 'issue type screen schemes'
  3. Click 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. Click 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.

Deleting an issue type screen scheme

  1. Log in as a user with the JIRA Administrators global permission.
  2. Choose > Issues. Select Screens > Issue Type Screen Schemes to open the View Issue Type Screen Schemes page.
    (tick) Keyboard shortcut: 'g' + 'g' + start typing 'issue type screen schemes'
  3. Click the Delete link next to the Issue Type Screen Scheme you wish to delete.

Icon

Issue Type Screen Schemes that are associated with a project cannot be deleted.

Copying an issue type screen scheme

  1. Log in as a user with the JIRA Administrators global permission.
  2. Choose > Issues. Select Screens > Issue Type Screen Schemes to open the View Issue Type Screen Schemes page.
    (tick) Keyboard shortcut: 'g' + 'g' + start typing 'issue type screen schemes'
  3. Click 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.

Associating 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. Log in as a user with the JIRA Administrators global permission.
  2. Choose > Projects.
  3. Select the project you wish to configure by clicking on its name.
  4. Select Screens, you should see something like this:
  5. Click the Actions dropdown menu and choose Use a different scheme.
  6. Select the Screen Scheme you wish to associate with this project.
  7. Click the Associate button.
Icon

To control which issue types apply to a project, please see 'Associating Issue Types with Projects'.

2 Comments

  1. Anonymous

    Hello,

    If I have project A using issue type scheme A; and project B using issue type scheme B. Is it possible to link issues from project A with issues from project B?

    Thanks for your help.

  2. How can I associate a different screen (the default screen) to a sub-task of an issue, while the issue its self retains a custom screen that my workflow has associated with it? This may be an easy question with an easy solutions, but I'm new to JIRA.