Label Tools for Confluence
Rename, merge and remove labels across a whole space, add or remove labels on many pages at once, find pages without labels, and export every page with its labels.
Where to find it
Open a space, then Space apps → Label Tools in the sidebar. Confluence admins also have Apps → Label Tools at the top, where any space can be picked.
Who may do what
| Action | Who |
|---|---|
| See labels, counts, pages and history | Anyone who can see the space |
| Rename, merge, remove, add or remove labels in bulk | Space admins of that space and Confluence admins |
Changes are made as you, so a page you cannot edit stops the run with Confluence's own error, and you can retry after fixing the permission.
Labels tab
- Counts. Every label used in the space with the number of pages and blog posts carrying it. The first 150 labels are counted and the tab says when a space has more; the rest can be handled from the Pages tab with a search such as
label = "name". - Rename. Adds the new name to every page that has the old one, then removes the old one. A page that already has both only loses the old name.
- Merge. Tick several labels, type the label to merge them into, and every page carrying any of them gets the target and loses the others.
- Remove from all pages. Takes the label off every page in the space.
Pages tab
Find pages by a CQL search or by a page tree, then add or remove labels on all of them. The search is always limited to pages and blog posts in the space, results are checked against the space again, unbalanced quotes or parentheses are refused, and any ORDER BY you type is dropped. A tree is the root page plus everything under it.
Unlabelled tab
Lists pages with no labels at all (the first 2,000 pages are scanned and the tab says so when a space has more), lets you label them in one go, and offers Export CSV: every page and blog post in the space with its type, labels and label count, fetched in chunks so large spaces export completely.
How a run works
Every change shows a preview first: the pages selected, how many will change and how many already have the right labels. The run then goes page by page, in slices, with a progress bar. If Confluence refuses a page the run stops there; Retry from the failed page continues without repeating earlier pages, and Skip this page and continue leaves a page you cannot edit behind. Stop ends a run within a page, and pages already processed keep their new labels. Adding a label a page already has, or removing one it lacks, is harmless, so a repeated step never damages anything. Runs are listed under History for 30 days and can be continued by the person who started them or by a Confluence admin.
Label names
Confluence labels are lowercase and cannot contain spaces or characters such as , ! # & ( ) * . : ; < > ? @ [ ] ^. The app lowercases what you type, turns spaces into dashes and drops the rest, and shows the result in the preview before anything changes.
Limits
- 2,000 pages per run; a larger selection is cut at 2,000 and the preview says so. Run again for the rest.
- 150 labels counted per space.
- Only global labels are handled; personal ("my:") and team labels are left alone. Existing label names are matched exactly as they are; only new names you type are normalised.
- Runs are kept for 30 days.
Data
The app stores only its run records (operation, page ids and titles, progress, who ran it) in Forge storage inside your Atlassian site's region for 30 days. Nothing leaves Atlassian. See Privacy.
Changelog
- 1.0 (November 2026): first release.
