Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

delete labels

Deleted user Jan 22, 2019

How can I delete labels from a Confluence Cloud space? Doesn't have to be globally, one by one would be fine.

3 answers

1 accepted

0 votes
Answer accepted

Hi Julie,

If you are using labels to categorize spaces - sometimes referred to as space categories but also as space labels - the following documentation describes how to add but also how to remove them:

Best, Tobias

Deleted user Jan 24, 2019

Thanks Tobias, however I apologise for not framing my question very well. Let me try again! I am managing a space with lots of collaborators, and we have lots of labels to choose from when labelling a page. With many labels that are similar, it is often difficult to choose the "real" one, i.e. the one that will drive the content by label report. How can I get rid of all those extraneous labels so they do not show up when people start typing a label name. It is too easy to choose the wrong one because there are so many that are similar. I'd like to clean them up and only leave a smaller number to choose from.

Like shirley likes this

Unfortunately there is no way to do this using the user interface... 

However you might want to try the commercial "Labels Cage" app which allows you to manage labels in a more restricted way.

Best, Tobias

Deleted user Jan 28, 2019

Thanks so much Tobias, even when the answer is "it can't be done", it is great to know the truth. Also, thanks for that link, I am interested to see what is behind it. Will give it a go.

Like Spencer Holt likes this
1 vote
Diego Atlassian Team Apr 10, 2020

Hello @[deleted]  and everyone else who might need to delete labels from their sites.

We can delete the labels from our spaces. The thing is that the process is entirely manual in Confluence.

For us to remove a label from a space, we need to remove it from each piece of content that contains it.

Here is how you can test this:

  1. Create a couple new pages
  2. Publish the pages
  3. Label each page with a new label (I will use welcome as a label)                   Screen Shot 2020-04-10 at 14.52.15.png
  4. Create a new page
  5. Place the Labels List macro in it                                                                                  Screen Shot 2020-04-10 at 14.43.23.png
  6. Publish the page
  7. Be sure that all newly created pages are within the same space
  8. Go to the page that contains our Labels List macro (I will call this page Labels Page)                                                                                                                            
  9. Check that the newly created label is listed there in the macro                                Screen Shot 2020-04-10 at 14.54.14.png
  10. Click the link that refers to the newly created label
  11. This will lead you into a page that shows all content that contains that specific label.                                                                                                                        Screen Shot 2020-04-10 at 14.54.48.png                  
  12. Now, for each content piece, visit it and remove the label from it.     Screen Shot 2020-04-10 at 14.55.46.png
  13. After removing the label from all content, go back to the Labels Page
  14. You will now see that the label is no longer listed there.    Screen Shot 2020-04-10 at 14.56.38.png

Something to keep in mind is that questions do count as content and if you need to remove any label that is also present there, you will need to remove the label from your questions as well.
Labels are called Topics in Questions for Confluence.

Other than the native method of removal, you can also try the Command Line Interface from BobSwift, as explained in this other thread:

Here is the documentation for the procedure using CLI:

I hope this helps you and everyone who needs to remove labels! Let us know your thoughts on this.

Hi Diego (and others). 

I was really happy to read this detailled description as I thought it would solve my challenge in removing labels from Confluence. However, it doesn´t seem that your description is correct? Let me explain: We have Confluence Server, version 7.1.0. We use Label list macro. We have a label called reptiles, and the label is listed in Label list macro. I click on that label in order to see what pages use reptile-label. There are no pages that use that label. Then I thought maybe the label was used in another Space, so I checked and searched globally for that label. And still no pages was found. Sooo, as far as I can understand what you wrote in your reply here isn´t accurate? Or what am I missing here?


I just realised that this community is for Confluence Cloud. Sorry about that. Does this mean that removing labels only can be done in Cloud?Screenshot 2020-05-12 at 10.33.51.png

Like Debra Graham likes this


I am having the same problem as @[deleted]

I've deleted all the instances of a label but it still appears in the output of the Labels List macro.  

I have detailed my problem with getting rid of old or inaccurate labels here:

This problem is becoming more urgent for my company as we have engaged a firm to help us with SEO.  I am trying to clean up our labels but they aren;t being entirely deleted.  They are deleted from the page they were displayed on but they still appear in the output of the Labels List macro.  We use the Labels List macro on some pages as a way for users to search for information.

I set up some test labels to see the functionality of Confluence Knowledge Base and now I want to remove them. I see the same situation where even though a label is not used on a page, it shows in the labels list. If you click on it, it says no pages are available.


The labels list has a function to manually exclude labels you don't want listed. It is a bit cumbersome but I didn't have many so used this function, and now they don't show. It is a workaround in my situation, but certainly not good functionality. You should have an option with the labels list to not show a label that has no pages. 


Is this another situation where Atlassian does not have the functionality needed and you have to buy it from a vendor app?? 

Like TheJag likes this

apologies, posted on accident

Hi Cassandra 
 I had the same problem - but not in Cloud so not sure if this will work for Cloud users.
I went to the Space admin tools -> Content Tools -> Trash and Purged the deleted pages and the labels list updated automatically.

I think having deleted pages still retains the labels till they are purged.

Very good info and makes sense. I will try a test with that. Thanks!

Like TheJag likes this

I did test this and TheJag is absolutely right. If you empty your trash (or at least of pages with labels you don't want), the labels no longer show. 

Like TheJag likes this

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Apps & Integrations

🍻🍂Apptoberfest Update: Upcoming Virtual Events 🎉

Hello Community! I hope you've been enjoying the 🍂Apptoberfestivities🍂 (I know I have!) The event is heating up next week with a series of virtual events that we're calling the 🍻🍂Partner App ...

107 views 1 8
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you