Atly AppsDocumentation
Learn how to view, rename, merge, and bulk-delete labels across your Confluence spaces — from a single control panel.
01Getting started
Label Organizer for Confluence gives you a central control panel to see where every label is used, and powerful bulk tools to rename, merge, and delete labels across your spaces.
To get started, open a Confluence space and click Label organizer in the space sidebar under "Space apps".
Here you can see all labels used in that space, along with the number of pages, blog posts and attachments each label is assigned to. Click the See usage link to view that labelled content in Confluence. Use the Export CSV button to download the full label list as a CSV file.
If the “Labelled content” page shows no results, the content may be archived or restricted. Only labels with the global prefix (when added via the Confluence API) are shown in Label Organizer.
02Viewing labels across all spaces
To view and organize labels across your entire Confluence instance, open Label Organizer from Global settings:
- Click the gear icon in the top-right of Confluence.
- Expand Apps in the left sidebar.
- Click Label organizer.
03Filtering labels
To filter the label list, click the search box and type a search term. The table updates to show only labels containing that term.
04Organizing individual labels
When using Label Organizer in a specific space, edits apply only to content in that space. To edit labels globally, use Label Organizer from Global settings.
To delete or rename an individual label, click the three dots at the end of the table row and select Delete or Rename.
05Organizing multiple labels
To delete or merge several labels, click the checkbox on the left of each label, then select Delete or Merge.
When deleting, you'll be prompted to confirm. When merging, you'll choose a target label that all selected labels are merged into.
06Adding labels
To add a label to pages, blog posts or attachments, click Add label from the main screen, or click the three dots on a label row. Enter a label name and a CQL search query to find the content to tag.
If you need help with CQL syntax, click the question mark icon in the search field.
CQL searches run across your entire Confluence instance by default. To limit results to the current space, add a space clause to your query.
Once the results look right, click Add label to items.
07FAQ
Can I rename or merge labels across multiple spaces at once?
Yes. Open Label Organizer from Global settings (gear icon → Apps → Label organizer) to manage labels across your entire Confluence instance. Changes made there apply globally, not just to a single space.
What's the difference between Delete and Merge?
Deleteremoves the label from all content it's assigned to. Merge replaces one or more labels with a single target label — useful for consolidating duplicates or typos without losing the categorisation.
Will renaming a label affect archived or restricted pages?
Label Organizer only operates on content that is visible to the current user. Archived or restricted pages you don't have access to will not be affected by rename or delete operations.
Which Confluence plans does this work with?
Label Organizer works with all Confluence Cloud plans, including Free, Standard, Premium and Enterprise. It is not compatible with Confluence Data Center or Server.
Is my data sent to Atly's servers?
No. Label Organizer is built on Atlassian Forge and runs entirely on Atlassian's own infrastructure. Your content is never sent to or stored on Atly's servers.