How do I find all labels in Jira?

[An Le Nguyen]

I would like to see a list of all labels that are currently in use in Jira. How might I do that?

[Martin Bayer _MoroSystems_ s_r_o__ · Accepted solution]

Hi @An Le Nguyen you can use REST API endpoint:
https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-labels/#api-rest-api-3-label-get

Your request can look like

• https://yourdomain.atlassian.net/rest/api/3/label

You need to use pagination if you have more than 1000 labels, so just let me know if it is your case and we can work on it

[Michael Hart]

@Martin Bayer _MoroSystems_ s_r_o__ 

Thanks for the link to the REST API endpoint! It solved my problem. I do have a couple of areas where that article could be improved, though. (I also left this as feedback on that page.)

For cURL, please add some notes for Windows users:

1. cURL in Windows must use double quotes (") not single quotes (')! Single quotes will not work with in Windows!!
2. Remove the \ before copy and pasting. No newlines allowed.
3. Be aware that <API_TOKEN> should be removed ENTIRELY, including the less than and greater than signs (< >).

It took a bit if of futzing around for me to figure this out. The article got me 95% of the way there, but the last bits were slowing me down.

Oh, also:

1. To generate an API token
   1. https://id.atlassian.com/manage-profile/security
   2. Click on "Create and manage API tokens"
   3. Click "Create API Token"
   4. Name it
   5. Copy the API token somewhere safe

[Martin Bayer _MoroSystems_ s_r_o__]

Good job @Michael Hart ;)

[John Worrall]

I'm glad you figured something out, but honestly, we should not need to learn how to use REST API endpoints to get a list of what labels are in Jira.

[Andrea Hardy]

Another solution that is a bit easier.. add a new gadget to a dashboard.

Select Add Gadget - Load All Gadgets - (scroll) Select Heat Map - Find the relevant filter for your project that includes ALL items (if not available create just a basic issue search that selects your project) Statistic Type should be: Label - select okay - Done :-)

This will show all labels currently in use by the selected project. 

[Jack Brickey]

Here is one thing you could do - use this JQL labels is not empty  to find all issues that have a label. Export this list, I recommend removing as many columns as possible if you have a large database. Then use excel formulas such as pivot table to find up every unique label. Not glamorous but it will work.

[Atly Apps]

Hi An,

In addition to the other answers, we recently released a third-party app - Label Organizer for Jira Cloud - which provides the ability to view and organize (merge, rename, bulk-delete and bulk-assign) labels in Jira tenant:

You can view and organize labels either in a whole Jira instance or a single Jira project.

It's totally free for organisations with less than 10 users, and we've tried to price it very economically for organisations with more users. Please don't hesitate to contact us if you have any questions or suggestions.

[Incident]

We're finding that this API is too slow (taking over 90 seconds, and not returning) for some of our customers - even ones with ~500 labels.

Is there any other way to get the labels from the API? 

[Nar Kumar C_ - Narva Software]

Hi everyone,

If you want to have a nice interface to view all labels as well as manage (view all labels in a project or all projects in one place, rename or merge and delete if needed), please try our app:

Label Manager for Jira Cloud

You can also search Atlassian Marketplace for relevant apps here if you need something else.

[Magdalena Zhisheva]

Hi @Martin Bayer _MoroSystems_ s_r_o__ , 

Can you share how to use pagination if you have more than 1000 labels?

Thank you in advance for your assistance on this!

[Martin Bayer _MoroSystems_ s_r_o__]

Hi @Magdalena Zhisheva you need to use query parameters

• startAt
• maxResults

For example if your page has two elements you need to invoke

• {URL}/rest/api/3/label?startAt=0&maxResults=2 -  get first and second label
• {URL}/rest/api/3/label?startAt=2&maxResults=2 -  get third and second fourth
• ...

[Magdalena Zhisheva]

@Martin Bayer _MoroSystems_ s_r_o__ , 

Thank you very much!