Label Cleanup for Jira

Try or install on the Atlassian Marketplace.

Rename, merge and delete Jira labels across all your issues. Every change starts with a dry run, only the exact spelling you choose is changed, notifications are off by default, and any change can be undone for 30 days. Jira Cloud has no built-in way to edit labels (JRACLOUD-33672).

Getting started

  1. Install the app from the Atlassian Marketplace.
  2. Open Jira Settings → Apps → Label Cleanup (Jira admins), or Apps → Label Cleanup (people an admin has allowed).
  3. On the Labels tab, find the label and click Clean up.
  4. Choose Rename, Merge into another label or Delete, optionally pick one project, and click Dry run.
  5. Check the numbers, then click Change.

Labels tab

Dry run

The dry run shows the number of issues with exactly that spelling, how many already have the new label, the projects touched, example issue keys, and issues you can't edit (they are skipped). Nothing changes until you click Change. Delete asks you to type the label name. A dry run can be used for 24 hours.

Running a change

Undo

Click Undo on a finished change within 30 days. The old label goes back on every issue that lost it, and the new label is removed only where the change added it.

Settings (Jira admins)

People also need Jira's Make bulk changes global permission, and Browse and Edit issues in each project.

Limits

Data

Label Cleanup stores its settings and, for 30 days, the issue ids each change touched (for undo) in Atlassian Forge storage. It makes no calls outside Atlassian. Uninstalling removes the stored data; labels on issues stay as they are.

Support

Email support@funaticilluminations.com with your Jira site URL and what you tried.