Associating priorities with projects

Defining priority field values

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

Once you're happy with the priorities available in your Jira instance, it's time to associate them with some projects. You can choose a different set of priorities for each project by using priority schemes.

What's a priority scheme?

A priority scheme works like a mapping that allows you to associate a subset of priorities with particular projects. You can use it to achieve the following goals:

  • restrict the set of available priorities for a project,
  • control the order in which priorities are displayed,
  • select a default priority that is assigned to all newly created issues in a project.

A single priority scheme can be reused across multiple projects so that a group of similar projects (i.e. projects which might be used for similar purposes) can share the same priorities. It's also easier to add or remove priorities for these projects because all you need to modify is a single priority scheme. 

Default priority scheme

Jira comes with a default priority scheme that contains all priorities, and is associated with all projects until you change it. You can't edit this scheme, but you can associate it as you wish.

Managing priority schemes

To manage priority schemes and complete the actions listed below:

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

  2. Under Priorities (the left-side panel), select Priority schemes. You need to have the Jira admin global permissions to get there.

Priority schemes in Jira admin console, with annotations explained below the image.

  1. This is where you can find all priority schemes
  2. Priorities used by a scheme.
  3. A list of projects that use this set of priorities.
  4. Actions that you can perform on a scheme: Edit, Associate, and Delete.

Creating priority schemes

Managing priority schemes is difficult if you don't have any. Create a priority scheme, and decide which priorities apply to it. 

To create a priority scheme:

  1. From the Priority schemes page, select Add priority scheme.
  2. Enter the name and description for your scheme. Make it meaningful, so that other admins know they can reuse this scheme instead of creating a new one.
  3. Add priorities by dragging and dropping them from Available priorities to Selected priorities. The order on the list matters—that's how your users will see priorities when assigning them to issues.
  4. Select a default priority. It will be preselected whenever an issue is created in a project that uses this scheme.

Associating priority schemes

Next, associate your priority scheme with a project.

  1. From the Priority schemes page, select Associate next to the priority scheme you want to associate.
  2. Select the projects that you want this scheme to apply to. If a project is already using a different scheme, it will switch to this one.
  3. If some issues in the projects you've selected use priorities that are not available in this scheme, you'll be asked to choose priorities that will replace them. See Replacing obsolete priorities.

Other actions

Apart from creating and associating priority schemes, you can also edit and delete them.

ActionDescription
Editing

To edit a priority scheme, select Edit next to the scheme you want to edit, and then change the name, default priority, or priorities selected for this scheme.

If you removed priorities that are currently in use by some issues, you'll be asked to choose priorities that will replace them. See Replacing obsolete priorities.

Deleting

To delete a priority scheme, select Delete next to the scheme you want to delete. There are certain restrictions:

  • You can't edit, or delete the default priority scheme.
  • You can't delete priority schemes that are used by some projects. You can see how many projects are using a scheme on the Priorities scheme page (Projects). Associate these projects with a scheme (e.g. the default scheme), and proceed with deleting.
Ordering with JQL

It's important to know how JQL works with priorities. If you use JQL to order issues by their priorities (e.g. descending), they will be ordered according to the importance of the priorities on the global list of priorities. The global list is what's displayed on the Priorities page. The order from priority schemes is not relevant for JQL. To put it in an example, let's say the priorities in your Jira instance are arranged in the following way:

Global list (Priorities page)Custom priority scheme
  1. Urgent
  2. Highest
  3. Medium
  1. Highest
  2. Urgent
  3. Medium

After appending a JQL query with e.g. ORDER BY priority DESC, the Urgent issues will be at the top of the list (followed by Highest, and then Medium), even if they’re in a project that uses the custom scheme. You can change the order in the default scheme on the Priorities page.

Replacing obsolete priorities

When you edit an existing scheme or associate a scheme with projects that were already using a different one, you might be asked to replace obsolete priorities. That's because some issues are using priorities that are not available in the new or edited scheme. An issue can't live without a priority, so you need to replace the old with the new. It's simply about choosing e.g. Highest (new scheme) to replace Top (current scheme). Once you select priorities, we'll update all these issues for you.

Last modified on Oct 7, 2022

Was this helpful?

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