Label Cleanup / Docs

Label Cleanup documentation

Last updated 11/11/2026

Label Cleanup for Jira gives Jira administrators one page to see every label on the site with exact usage counts, find labels that are spelt more than one way, and rename, merge or delete labels across every work item - always with a dry-run preview first.

Quick start

1. Install Label Cleanup for Jira from the Atlassian Marketplace and approve its permissions.
2. Open Settings (cog) > Apps > Label Cleanup as a Jira administrator.
3. Scan usage to count how many work items carry each label.
4. Open the Variants tab and choose Merge on a group, or tick labels on the Labels tab and choose Rename, Merge or Delete.
5. Preview, check the counts and sample work items, then Apply.

Each step is explained in detail on the pages below.

• Get startedInstall Label Cleanup for Jira, open it from Jira settings and run your first usage scan - numbered setup steps for Jira administrators.
• Labels and usage countsThe Labels tab is the inventory of every label on your Jira site. Open Settings (cog) > Apps > Label Cleanup. The Labels tab opens first.
• Find case and spelling variantsThe Variants tab groups labels that are probably meant to be the same label. Run a usage scan first (Get started, step 5) so suggestions use real counts.
• Rename, merge or delete labelsStep by step: rename, merge or delete Jira labels across every work item, with a dry-run preview of exactly what will change before anything runs.
• History, stop and resumeOpen the History tab. It lists the last 50 scans and changes with start time, result and status. Choose Details on a job to see when it was confirmed…
• Limits and troubleshootingLabel Cleanup limits - work items per job, labels per merge, scan size, preview expiry - and what each message in the app means and how to fix it.
• Data and privacyLabel Cleanup runs entirely on Atlassian's platform (Runs on Atlassian) and sends no data anywhere else. Stored in your site's app storage: job records…
• Release notesFirst Marketplace release of Label Cleanup for Jira. Every label with exact, case-sensitive usage counts. Case and spelling variants grouped with a…