Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

With Project Labels, we aim to make using labels on your Jira Cloud instance much easier by giving every team member a place to manage the labels used in their project.

Working with the Project Labels app is done from the directly from your project. Once the app has been installed, a new menu item called Label Manager will appear in every project. Click on it to get to the Label Manager.

Selecting Label Color Settings

...

Just like other settings - you can select the ‘Label Color Settings' in the global administrations page for all projects or decide to use projects specific ‘Label Color Settings' in the project administrations page.

 

You can choose between two Label Color Settings Options

  • Label Specific Color

  • Issue Specific Traffic-Light Label Color

 

Option 1: Label Specific Color (default)

...

Label Specific Color is enabled by default.

...

Create a Colored Label Manager custom field

Info

Managing native Jira labels don’t require creating a Colored Label Manager custom field.

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

  • Activate coloring to labels.

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

  • Add a description to your label to make the context more clear to your project users ,Your team 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..

Colored Label Manager custom fields can be created like Jira native custom fields

As Jira Administrator:

  1. 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-20241109-233711.pngImage Added

     

    1. Enter a Name and Description

    2. Click Create

      

Info

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

 

 

...

 

You should see something like this:

 

Jira Search by Label.pngImage Added

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

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

Again you can define that color globally for the label or decide to use your Users can use their own colors within your projecttheir projects.

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

Once ‘Label Secific Color’ is selected in ‘3. Label Color Settings'. The Action ‘Change Color’ appears in the label rows.

...

You can always change the label color.

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

...

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

...

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

...

This is a list of all the Jira labels used in your project. The second 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

Renaming a label is done in place; just click on the label you want to rename, make a change and then click on the checkmark to the right of the input box. All issues with that label will be updated to use the new label name.

...

Using Colored Label Manager for Jira, you can edit the label name as needed. 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

To rename labels in a project, go to Project → Manage Labels instead.

...

 

Info

Please note: If you are in global mode, administrative actions (rename, delete etc.) will affect all projects. If you do not want this, use per project label management.

Merging Jira Labels

Sometimes, you will need to merge two labels. Typically, this happens when you notice different spellings for what should be the same label, like in the screenshot below:

...

Dealing with this situation is really easy with Project Labels: Simply rename the unwanted spellings to the spelling you would like to keep.

Deleting a Jira Label

Deleting a label is just as easy as you would expect. Simply click the trashcan icon next to the label you want to delete. You will then be asked to confirm that you want the label deleted:

...

Click Delete to remove the label from all issues in your current project.

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.

You can get rid of labels that are not needed anymore in your Jira environment. If you just want to rename or merge the duplicate labels, please refer to this page Rename labels in Jira instead.

To delete a label globally:

  1. Go to Apps → Manage Labels

  2. Find the label and click Delete. A confirm window will open, click OK.

If you have a label that is used in too many issues, this operation might take a while.

To delete a label only in a project, go to Project → Manage Labels instead.

Delete a label in Jira

...

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

Add label to multiple Jira issues

...

Jira instance, in this view you can manage Global Colored labels :

  1. Create label and add it to a Jira issues

  2. Add color to labels

  3. Add description to labels

  4. Search for specific labels

  5. Check how many issues one label is assinged

  6. Export labels to CSV

  7. Edit labels

  8. Merge labels

  9. Delete one or multiple labels

  10. Add label to multiple Jira issues.

  11. Remove label from multiple Jira issues

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.

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.