Label Cleanup / Docs / Get started
Get started
Last updated 11/11/2026
Label Cleanup is a Jira Cloud admin page. There is nothing to configure: install it, open it, and run a usage scan.
Who can use it
Only people with the Administer Jira global permission. Everyone else cannot open the page, and the app refuses their requests on the server as well.
Set up Label Cleanup
- Install the app. In Jira, go to Settings (cog) > Apps > Explore apps, search for Label Cleanup for Jira and choose Get app (or use Get it now on the Marketplace listing and pick your Jira Cloud site). Paid sites start with a free trial; sites with up to 10 users are free.
- Approve the permissions. The app asks to read and write Jira work items (to find labels and change the Labels field) and to use app storage (for job records and usage counts). It requests no external network access.
- Open the app. Go to Settings (cog) > Apps. In the left sidebar, under the apps section, choose Label Cleanup.
- Check the Labels tab. It lists every label on the site, A-Z. Counts show "-" until you run a usage scan.
- Run a usage scan. Choose Scan usage. The scan runs in the background, so you can leave the page and come back. When it finishes, each label shows the exact number of work items that carry it, letter case included, ordered most-used first.
That's all the setup there is. Next: find variants or rename, merge or delete labels.