Label Organizer for Jira Cloud Documentation

Getting started

Label organizer for Jira improves your experience using labels in Jira. It provides a simple control panel which allows you understand where your labels are being used, as well as powerful functionality to cleanup and organize labels in bulk.

To get started organizing your labels, open a project and click on the "Label organizer" section of the project sidebar.

Displaying Jira labels in a project

Here you're able to a see a list of all the labels that are used in that Jira project, as well as the number of issues that the label is assigned to. In order to see a list of these issues, click on the link (for example, "1 issue"). This page will then open a browser tab. To return to Label organizer, simply close this new tab.

Viewing labels used in all projects

In addition to viewing all labels used in a single Jira project, you can also view and organize all labels that are used throughout your Jira instance by going to Label organizer in Global settings:

  1. Click on the gear icon in the top-right section of Jira
  2. Select "Apps"
  3. Open "Label organizer" in the sidebar on the left

Filtering the list of labels

In order to filter the list of labels shown in the table, click on the search box and enter a search term. This will filter the items in the table to only show labels that contain the search term.

Filtering from a list of labels

Organizing individual labels

When using Label organizer in a specific Jira project, editing labels (deleting, renaming and merging labels) will only apply to issues in the project that you're viewing. To edit labels globally, use Label organizer in the settings section of Jira.

To delete or rename an individual label, click on the three dots at the end of the table row and select either "Delete" or "Rename".

Delete and rename buttons visible

When deleting a label, you'll then be prompted to confirm the label that you're deleting.

Please note that deleted labels can still be suggested in the list of RECENT LABELS when editing a Jira issue. This is because such label suggestions are cached for a period of time in your browser by Jira (in localStorage).

When renaming a label, you'll be prompted for the new label name that you'd like to rename the label to.

Rename modal visible

Organizing multiple labels

Deleting or merging labels multiple labels together can be done by clicking the checkbox on the left side of several labels and selecting either "Delete" or "Rename".

When deleting several labels, you'll then be prompted to confirm the labels that you're deleting. When merging several labels together, you'll be prompted to select that label that all selected labels should be merged into.

Adding labels

To add a label to issues, either click the "Add label" button from the main screen, or click on the three dots at the end of the table row

Then enter a label name (if adding a new label) and enter a JQL search query. If you need help with the JQL search syntax, click on the question mark icon in the search field.

Please note that if you're using Label organizer in a specific Jira project, the results from your search query can come from other Jira projects. You can limit your search to the current project by following the instructions in this Atlassian support document.

Once your search query is ready, click on the search button and a list of results will be returned.

If you're them happy with the list of results that the label will be added to, click on the "Add label to items" button.

Add labels modal visible