Hullspark

Label Sweep for Confluence

Bulk label management for Confluence. Find duplicate labels, then merge, rename or delete them across pages and blog posts. A dry run shows the affected pages first.

Try it on the Atlassian Marketplace Getting started: your first label merge in four steps 日本語のページ

Free for up to 10 users; see the Marketplace listing for paid tiers. Runs entirely on Atlassian. For Confluence Cloud.

Label Sweep list of duplicate label groups with usage counts
Possible duplicate labels: groups with usage counts and a suggested label to keep.

In four lines

  1. The problemhow-to, how_to and howto are three labels, so a label search misses pages. Confluence has no built-in way to rename, merge or bulk-delete labels.
  2. Where it is on screenApps, then Label Sweep, then the Labels tab: Possible duplicate labels and Label check.
  3. What you doFind a group of likely duplicates, press Merge this group…, read the dry run, then run it.
  4. What you getOne label instead of three, so label searches stop missing pages. The Jobs tab keeps a log, page by page.
Label Sweep demo video thumbnail
Demo video. Nothing loads from YouTube until you press play.

What you can do

Find duplicate labels in one list

Labels that differ only by plural or by hyphen, underscore or no separator are grouped, with usage counts and a suggested label to keep.

Merge a whole group in one go

Merge this group… fills in the merge form and starts a dry run. The dry run lists what will change. Nothing changes until you press Run.

Merge form filled in with a dry run note
The merge form filled in, with the dry run result. Nothing has been changed yet.

One last check before it runs

The confirmation names the change and says how many items it touches. It also says plainly that the change cannot be undone, which is why the dry run comes first.

Confirmation dialog showing how many content items will be changed
The confirmation dialog before a merge runs.

A label check that points to the mess

Label check also finds labels used on only one page, labels written differently from the rest, and very long labels. It only suggests. You decide what to change.

Label check summary with four checks
Label check: how many checks found labels worth reviewing, and a suggested action for each.

Every change is logged

Jobs show how many items were updated, how many failed, and a log per job. An interrupted job can be resumed where it stopped.

Jobs tab with finished jobs and counts
The Jobs tab with finished jobs.

Good to know before you start

  • Covers pages and blog posts (global labels). Attachment labels and space labels are not handled yet.
  • Starting a change needs a Confluence administrator and an active license. A job runs with the permissions of that person, so pages they cannot edit are not changed.
  • Label names must be lower-case with no spaces.
  • There is no undo. Use the dry run, and check the confirmation before you run.
  • Without a license the app is read-only: listing, search and dry run work, but Rename, Merge and Delete are disabled.

Questions

Why are Rename, Merge and Delete disabled?

The app is in read-only mode, which happens when it is not licensed, for example after a trial ends. Listing, search and dry run keep working. Once the license is active in Apps, Manage apps, the buttons come back.

I closed the tab, and a job shows “failed”. Is my site half-changed?

Jobs run in the background on Atlassian in resumable chunks, so closing the tab is fine. Each page is processed as “add the new label, then remove the old one”, so a job that stops partway leaves pages either untouched or fully converted, never with labels lost. Press Resume and it continues where it stopped.

Which content and labels does it cover?

Pages and blog posts, with global labels. Attachment labels and space labels are not handled yet.

Does my data leave Atlassian?

No. The app runs on Atlassian. Details are in the privacy policy.

What does it cost?

Free for up to 10 users; see the Marketplace listing for paid tiers.

Try it on the Atlassian Marketplace

Guide

Related Hullspark apps for Confluence

Other Hullspark apps

Questions? Support or support@hullspark.com.