Aldorock apps for Atlassian

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

ActionWho
See labels, counts, pages and historyAnyone who can see the space
Rename, merge, remove, add or remove labels in bulkSpace 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

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

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