Atly AppsDocumentation
Learn how to view, rename, merge, and bulk-delete labels across your Jira spaces — from a single control panel.
01Getting started
Label Organizer for Jira gives you a central control panel to see where every label is used, and powerful bulk tools to rename, merge, and delete labels across your spaces.
To get started, open a Jira space and click the Label organizer tab (which might be under the "More" section).
Here you can see all labels used in that space, along with the number of work items each label is assigned to. Click a count link (e.g. “1 work item”) to see those work items in a new tab. Use the Export CSV button to download the full label list as a CSV file.
02Viewing labels across all spaces
To view and organize labels across all your Jira spaces, open Label Organizer from Global settings:
- Click the gear icon in the top-right of Jira.
- Select Marketplace Apps.
- Open Label organizer in the left sidebar.
03Filtering labels
To filter the label list, click the search box and type a search term. The table updates to show only labels containing that term.
04Organizing individual labels
When using Label Organizer in a specific space, edits apply only to work items in that space. To edit labels globally, use Label Organizer from Global settings.
To delete or rename an individual label, click the three dots at the end of the table row and select Delete or Rename.
Deleted labels can still appear in Recent labels suggestions when editing a work item. This is because Jira caches label suggestions in your browser for a period of time.
05Organizing multiple labels
To delete or merge several labels, click the checkbox on the left of each label, then select Delete or Merge.
When deleting, you'll be prompted to confirm. When merging, you'll choose a target label that all selected labels are merged into.
06Adding labels
To add a label to work items, click Add label from the main screen, or click the three dots on a label row. Enter a label name and a JQL search query to find the work items to tag.
If you need help with JQL syntax, click the question mark icon in the search field.
JQL searches run across your entire Jira instance by default. To limit results to the current space, add a space clause to your query.
Once the results look right, click Add label to items.
07FAQ
Can I rename or merge labels across multiple spaces at once?
Yes. Open Label Organizer from Global settings (gear icon → Apps → Label organizer) to manage labels across your entire Jira instance. Changes made there apply globally, not just to a single space.
What's the difference between Delete and Merge?
Deleteremoves the label from all work items it's assigned to. Merge replaces one or more labels with a single target label — useful for consolidating duplicates or typos without losing the categorisation.
Why do deleted labels still appear in suggestions?
Jira caches label suggestions in your browser for a period of time, so deleted labels may still appear in Recent labels suggestions when editing a work item. This clears itself after the cache expires.
Which Jira plans does this work with?
Label Organizer works with all Jira Cloud plans, including Free, Standard, Premium and Enterprise. It is not compatible with Jira Data Center or Server.
Is my data sent to Atly's servers?
No. Label Organizer is built on Atlassian Forge and runs entirely on Atlassian's own infrastructure. Your content is never sent to or stored on Atly's servers.