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. 

[Bill Wohler]

I was able to choose my project and got all issues that way.

Thanks for the great suggestion about the heat map! I can see that this could be used to answer similar questions, as well as questions that are typically answered with a heat map.

[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.

[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!

[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.