Label Organizer for Confluence Cloud Documentation

Getting started

Label organizer for Confluence improves your experience using labels in Confluence. 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 space and click on the "Label organizer" section of the space sidebar.

Displaying Confluence labels in a space

Here you're able to a see a list of all the labels that are used in that Confluence space, as well as the number of pages, blog posts and attachments that the label is assigned to. In order to see a list of these blog posts and attachments, click on the "See usage " link. This page will then open a browser tab showing the "Labelled content" page in Confluence. To return to Label organizer, simply close this new tab.

If the "Labelled content" page states "There are no pages at the moment", this indicates that a given label exists in your Confluence account and is assigned to content, however your user is not permitted to access the content due to content restrictions. Confluence's admin key functionality can be used to bypass such restrictions and determine which content has this label applied.

Please note that if you have used the Confluence API to add labels to content, only labels with the global prefix will be shown in Label organizer.


Viewing labels used in all spaces

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

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

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 Confluence space, editing labels (deleting, renaming and merging labels) will only apply to content in the space that you're viewing. To edit labels globally, use Label organizer in the settings section of Confluence.

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. 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 pages, blog posts or attachments, 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 CQL search query. If you need help with the CQL search syntax, click on the question mark icon in the search field.

Please note that CQL searches by default are performed throughout your entire Confluence instance. If you're using Label organizer in a specific Confluence space, you can limit your search to the current space by following the instructions inthis 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