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

Earn badges and make progress

You're on your way to the next level! Join the Kudos program to earn points and save your progress.

Deleted user Avatar
Deleted user

Level 1: Seed

25 / 150 points

Next: Root


1 badge earned


Participate in fun challenges

Challenges come and go, but your rewards stay with you. Do more to earn more!


Gift kudos to your peers

What goes around comes around! Share the love by gifting kudos to your peers.


Rise up in the ranks

Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!


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.

4 answers

1 accepted

0 votes
Answer accepted
Tobias Anstett _K15t_
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
Jan 22, 2019

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
Tobias Anstett _K15t_
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
Jan 25, 2019

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

I went into the individual "label list" macro on a page to exclude the unwanted labels so that they don't show up in my label list.

1 vote
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
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 # people like 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 # people like 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 The Sloth 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 The Sloth likes this

Thank you @The Sloth ! That solution worked to remove the labels that were showing on the label index but were not on any pages.

Like The Sloth likes this

This works for most of my labels but I'm still having ghost labels persist that don't exist on any pages and my trash is purged.

@Andrea Rodriguez same here.  Some labels are persisting, but I'm wondering if it will take some time for the site to be indexed and then the ghost labels will disappear.

Suggest an answer

Log in or Sign up to answer
AUG Leaders

Atlassian Community Events