Create a Label Manager custom field
| Info |
|---|
‘Label Manager Custom fields are not supported inside team-managed projects in Jira. Use company managed projects instead. |
Features of Label Manager specific fields that are not supported on Jira native ‘Labels’ field.
...
Activate coloring to use labels as checklists by allowing users to assign issue specific traffic light colors to them.
...
Select 'Customize labels for this project' to manage predefined labels for this project independent from other projects.
| Info |
|---|
Colored Label Manager for Jira comes with a built-in Project Labels field, which you can start using immediately in your project. However, you are not limited to just one colored label field—you can create as many as needed for different purposes. For example:
✨ This flexibility allows teams to structure their work efficiently while maintaining clear visual distinctions with color-coded labels. |
Features
Features of Colored Label Manager Specific Fields (Not Supported on Jira Native ‘Labels’ Field) :
Activate coloring for labels: Add visual distinction to labels with colors
Customize labels per project: Select "Customize labels for this project" to manage predefined labels independently for this project, separate from other projects.
Restrict a label field As a project administrator, you can restrict the label field to prevent users from creating new label items. Users will be required to choose from existing ones, ensuring consistency across fields like Definition of Done (DoD), Definition of Ready, Acceptance Criteria, or simple select lists.
Independent label management: Allow project admins to manage available label items for their project independent from other projects or Jira administrator’s help.
Label Manager custom fields can be created like Jira native custom fields
As Jira Administrator: Settings → Issues → Custom fields (Side-navigation) → ‘Create custom field’ Button
Select ‘All’ → Search “Label” → Select “Label Manager for Jira”
Click Next
Enter a Name and Description and click Create
Optional: Associate the new created field with screens
Label Manager Custom Fields behave like normal custom fields and need to be put on the correct screens to appear in projects.
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.
Also new created Label have by default the color ‘grey-light’.
Label specific color means, that just like Epics, label will have a predefined color.
Again you can define that color globally for the label or decide to use your own colors within your project.
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.
...
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.
without dependency on other projects or assistance from Jira administrators.
Generating powerful reports: Create fully customized reports without any coding or knowledge of Jira Query Language (JQL). Simply select options from dropdowns to build reports.
Add descriptions to labels: Provide clarity for your project users by adding descriptions to labels. Users can check if a label already exists before creating it, avoiding duplicates caused by spelling or case variations.
...
Create a Colored Label Field
As Jira Administrator:
Access Apps:
Log in as a Jira Administrator.
Navigate to Apps in the Jira menu.
Open Colored Label Manager:
Go to Colored Label Manager under the Apps section.
Select Colored Label Fields:
Click on Colored Label Fields.
Create a New Label Field:
Click on Create Label Field.
Configure the field settings as needed (name,descriptions) then click Create .
...
| Info |
|---|
You can create multiple label fields for different use cases, such as:
|
| Info |
|---|
If you are working in a Service Management project, label fields are automatically added to your screens. However, for Software projects, you need to manually add label fields to the appropriate screens. |
Create a new Label-Item
On this page, you can create a new label item in your desired label field, assign it a name, a description and a color Then Click on Add Label
You can add it to one or multiple issues, or simply create it and allow Jira users to use it later.
| Info |
|---|
Since you can create multiple label fields (Definition of Done, Acceptance Criteria, or simple Select Lists), ensure that you are creating your label value under the correct label field. |
...
Selecting Label Color Settings
Just like other settings, you can select the project-specific "Label Color Settings" on the project administration page.
Newly created labels have the default color light grey.
A label-specific color means that, just like Epics, a label will have a predefined color.
Colors can indicate labels with higher priority or represent any meaning you define within your Jira instance.
You can always change a label’s color—simply select the color you want for the label. More colors will likely be added in the future.
Already assigned labels on issues will have their color updated based on your selection.
...
Checking Label Use in Your Project
Go to your project
...
, open Project Labels from the sidebar
...
, and you’ll see something like this:
...
...
This is a list of all the colored Jira labels used in your project. The second column shows you how many times
The description field is optional—use it to add context for your team and make your label field more clear .
The "Click to see issues" column shows how many time a label has been used.
...
Click the link to open a filtered view of all issues with that label in
...
a new tab.
Renaming a Jira Label
Renaming a label is done in place; just With the Colored Label Manager, you can easily rename labels. Simply 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 and update it.
The change will automatically apply to all issues using that label.
Steps to Rename Labels:
Go to your project.
Open the Project labelsLabels from the left sidebar.
Click on the label and rename it
To rename labels in a project, go to Project → Manage Labels instead.
...
i and Check ✓ .
| 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
...
may need to merge two
...
labels—especially if they’re duplicates due to spelling or case variations (as shown in the screenshot below
...
).
To merge labels:
Select the labels you want to combine.
Click Merge and choose the correct label to keep.
...
Deleting a Jira Label
Deleting a label is just as easy as you would expect. Simply click the To delete a label:
Click the red trashcan icon next to the label you want to
...
Click Delete to remove the label from all issues in your current project.
...
remove.
A pop-up will appear—confirm by clicking Delete.
...
Once a label is deleted, it will no longer be suggested when adding a label unless it is also label—unless it’s still 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:
Go to Apps → Manage Labels
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
Remove label from multiple Jira issues
...
| Info |
|---|
In some cases, deleted labels may still appear in the label field. For a workaround, refer to Known Issues & limitations |
Bulk Delete or add Jira Labels to issues
To bulk add or remove labels from issue , you simly click on +/-
...
To manage the label field across issues:
Bulk Remove: Uncheck "All Issues" to remove the label from every issue.
Specific Removal: Uncheck the box next to the specific issues you want to remove the label from.
Bulk Add: Check "All Issues" to add the label to every issue.
Specific Addition: Check the box next to the specific issues you want to add the label to.
...
Atlassian Expert good practices
Avoid using abbreviations unless they are widely understood and accepted by your team. This will help prevent the use of synonyms.
Always add a description to your label to make its context and usage clearer for your team.
Always check whether a label already exists before creating a new one; remember that differences in spelling or case variations might be the reason you don’t find it.
You can also click on "Click to see issues" to jump to the issue navigator and view a list of all issues with the label.
Need help?
💡 We're here for you! If you have questions or need to report a bug, visit our Help Center and raise a support ticket. Our team is ready to assist you!