π§© What is Labels Cleaner?
Labels Cleaner is a Jira app built on Atlassian Forge that helps teams manage and clean up Jira labels more efficiently. Over time, projects accumulate inconsistent, duplicated, or misspelled labels. This tool gives you a simple, centralized interface to identify, correct, merge, and delete those labels.
π Key Features
- π View and browse all labels used in selected Jira projects.
- π§Ή Identify misspelled, redundant, or unused labels.
- π Merge similar labels into one unified label.
- ποΈ Delete unwanted labels in bulk.
- π Secure: All actions are performed using the authenticated userβs permissions via
asUser()
.
π οΈ How It Works
- Installation
- Install the app via Atlassian Marketplace.
- Grant the app permissions to access your Jira workspace.
- Using the App
- Navigate to the app panel in the Jira sidebar.
- Select your desired project.
- The app fetches all labels used in that project.
- You can then:
- π Select two or more labels and click Merge.
- ποΈ Click the delte buttom beside a label to delete it.
- π§ Use suggestions to clean common spelling mistakes.
- Security
- All API calls that affect Jira data (like deleting or merging labels) are executed using
api.asUser()
to respect the logged-in userβs permissions.
- The app does not store any data outside of Jira.
- Only users with sufficient permissions (e.g., Project Admins) can perform actions.
π· Screenshots
The screenshot displays a confirmation modal with the message:
"Suggest correction for 'Ahmed'?"
indicating a feature to identify potentially incorrect or inconsistent labels.

The screenshot shows the Labels Cleaner interface in Jira. The user is prompted with a confirmation modal saying:
"Delete label 'label_18;label_31'?"
with options Yes or No.
