Project Colored Labels

Features of Colored Label Manager specific fields that are not supported on Jira native ‘Labels’ field.

  • Activate coloring to labels.

  • Select 'Customize labels for this project' to manage predefined labels for this project independent from other projects.

  • As a project administrator you can restrict a label field, in this case you prevent users to create new label items , they are required to choose existing ones.

    This fosters consistency across fields like Definition of Done (DoD), Definition of Ready, Acceptance Criteria, or Simple select list.

  • Allow project admins to manage available label items for their project independent from other projects or Jira administrator’s help.

  • Generating powerful reports , there’s absolutely no coding required and certainly no need to learn Jira Query Language (JQL) for that matter. You can make fully customized reports just by selecting options from dropdowns.

  • Add a description to your label to make the context more clear to your project users , Jira users can always check to see whether a label already exists before creating it; remember, too, that it might simply be a question of spelling or case variation..

 

As Jira Administrator:

  1. Click on Apps

  2. Go to → Colored Labels

  3. Click on Colored Label Fields

  4. Click on Create Colored Label Field

image-20240424-114412.png

 

  1. Enter a Name and Description

  2. Click Create

 

image-20240424-115730.png

You can create many label fields for different use cases: Project Phases , Feature Areas , Team Responsibility, Definition of Done (DoD), Definition of Ready, Acceptance Criteria or simple Select List.

PS : If you are in Service Management project ,label fields are added automatically to your screens.

 

In order to use label fields in Software project you should add them to the appropriate screens.

 

 

To check which software type project (Company-managed or Team-managed) you need help with, look at the bottom of your project’s left-hand sidebar: If you see an icon stating You’re in a team-managed project and Learn more menu items, you're in a team-managed project:

 

 

 

  • Select Project settings > Issue types > Search and add you colored label field

If you don't, you're in a company-managed project.

  • Select Project settings > Issues > Layout > Edit Issue Layout > Search and add your colored label field

 

 

 

Need help?

Please raise an issue in our Help Center in case of questions or to report a bug, we are here to support you.

Add label

Create a new Label

In this page you can create a new Label item in your desired label field and give it a description and a color , add it to one or multiple issues, or just create it and let it be used by Jira users.

As you can create multiple label fields like Definition of Done , Acceptance Criteria, or simple Select List , make sure that you are creating your label value under the right label field.

.

 

Atlassian Expert good practices

  • Avoid using abbreviations unless they are widely understood and accepted by your team. This will, in turn, help avoid synonyms.

  • Always add a description to your label to make context of uses more clear to your team .

  • Always check to see whether a label already exists before creating it; remember, too, that it might simply be a question of spelling or case variation.

  • You can also click on Click to see issues to jump to the issue navigator and see a list of all issues with the label.

Selecting Label Color Settings

Just like other settings - you can select the projects specific ‘Label Color Settings' in the project administrations page.

New created Label have by default the color grey-light.

Label specific color means, that just like Epics, label will have a predefined color.

Colors can indicate labels with higher priority, or whatever you like those colors to mean within your Jira instance.

You can always change the label color.

Just select the color you like the label to have. We will likely add more colors in the future.

Already assigned labels on issues will get the color updated based on selection.

 

Checking Label Use in Your Project​

Go to your project and open the Project Labels from the sidebar. You should see something like this:

This is a list of all the Jira Colored labels used in your project.

The description field is optional, you can use it to make the label context more clear to your team.

The Click to see issues column shows you how many times a label has been used. Clicking on that link opens a new tab with a filter that shows all issues with that label in your project.

Renaming a Jira Label​

Using Colored Label Manager, you can rename label as needed just click on the label you want to rename and make the change.

The renaming will be reflected in all issues where the label was used.

To rename labels:

  1. Go to your project

  2. Open the Project labels from the left sidebar.

  3. Click on the label and rename it

 

 

 

Merging Jira Labels​

Sometimes, you will need to merge two labels. remember, too, that it might simply be a question of spelling or case variation. like in the screenshot below:

To deal with this situation, simply select the labels to be merged and click on Merge and choose the right label .

 

Deleting a Jira Label​

Simply click the red trashcan icon next to the label you want to delete .

 

 

 

Bulk Delete Jira Labels

Simply select the needed labels and click on the button Delete

 

 

 

You will then be asked to confirm

 

 

Once a label has been deleted, it will no longer be suggested when adding a label unless it is also in use in another project.

Sometimes deleted labels are still suggested in label field, please refer to Known Issues & limitations for workaround.

Add label to multiple Jira issues

Simply click on the image-20240423-223117.png and check the needed issues , click on save and then label will be added to all the checked Jira issues .

Remove label from multiple Jira issues

Simply click on the image-20240423-223735.png and uncheck the needed issues , click on save and then label will be removed from all the unchecked Jira issues .

 

 

 

Need help?

Please raise an issue in our Help Center in case of questions or to report a bug, we are here to support you.