How do you delete unused labels?

We have a label map on our landing page showing all the popular labels in our space - it contains a whole bunch of labels that simply don't have pages associated with them. At first I assumed they existed on pages that were in the Trash, but I've since checked and the Trash is empty.

So how do I get rid of these labels? Or are we doomed to have an ever-growing map of unused tags?

That would make the product a lot less useful :(

8 answers

1 accepted

3 votes

You could also use the CLI for this:

confluence --action removeLabels --space "zconfluencecli" --title "This is title 0" --labels "testLabel1, testLabel2"

You can also getLabelList. In general that's a great utility for any kind of mass operation.

Ah, that looks like a handy option. I'll give it a try later, thanks!

Ok, so I've given that a crack - it says it has removed them, but sadly they have not disappeared from my labels heatmap macro. Any idea why that could be?

I completely agree with @Phil Lancaster on this matter. This absolutely needs to become a standard feature of confluence. Actually it seems to be a bug, that labels attached to no content at all, are displayed in popular label lists, etc. But I've browsed some related issues, and there seems to be quite some history with this matter. Unfortunately, the outcome is rather unsatisfying.

I agree with @Phil Lancaster and @Angelo Hannes as well, and think this should be a standard feature.  I've seen some plugins, but it makes no sense that a standard Macro would show labels that are not in use.  What purpose would that serve other than to clutter the interface.  

Is there anyway to stop this, other than find and filter out all the unwanted labels from the macro?

Hi Craig,

We shared our solution for this problem with Label Manager for Confluence before. You can find detail from link.

Moreover,if you need,this can be automated with a job as a new feature .

@Mert Karadağlı [KOSTEBEK TEKNOLOJI] your add-on is not a solution for this problem.

Hi @David Castano,

If you can create ticket from link , we can try to resolve your problem.

However, this feature was developed after other customers request and it worked successfully.

@Mert Karadağlı [KOSTEBEK TEKNOLOJI] I have created a ticket for this issue, and I really hope you can resolve it. 

I have exactly the same problem. Labels that are not attached to any page appearing in the labels list macro. Reindexing makes no difference except to inconvenience users while it's happening. I have no intention of using either the CLI or mucking around with the database to fix something that so obviously should just happen. If there are no pages associated with a label, it should disappear. This is a bug and should be just fixed without requiring a use case or 100 people reporting or documenting it. There's far to much of this kind of thing in Atlassian products.

Hi f1dave,

For this case, to get rid of this label I think it will be better to do it from database side. However please bear in mind that this might cause database inconsistency in your Confluence database, thus please shutdown your Confluence and backup your Confluence database and home directory before doing this.

You can delete it by running the following SQL query.


Please reindex after you've done so. Hope it helps.

Best regards,

Wow... having to do database queries to solve this? I would have thought this would be a reasonably common use case. :( Kind of makes the product a little less useful in that way.

Hm ... does the heatmap show spacewide or confluencewide tags ? Maybe you got them in another space.

Or perhaps this is an indexing problem? If so, it's a bug that we should report. Try reindexing (Administration >> Content Indexing).

It's for a specific space. All trash emptied for it. Content re-indexed. Same issue :(

Ah - sorry about the guess on the index. I just found it. It's at You'll need to purge the trash.

As I said in the original post, the trash has already been purged :(

I've deleted all the labels that I didn't want from the LABEL table, and the corresponding rows from the CONTENT_LABEL table, but the deleted labels are STILL showing up in the popular labels heatmap. How can I purge them from the heatmap as well? I have re-indexed, purged trash, looked for orphaned pages, etc. They are all gone. There are no labels which correspond to these entries. Where else can I go to delete them from the heatmap?

Having the same Problem with Version 5.5.3

Mario SBB Switzerland

Are the labels on attachments?


We added new features to  Label Manager for Confluence plugin to remove unused (orphaned) labels exists on deleted contents

You can find detail from link.

Best regards,

@Mert Karadağlı [KOSTEBEK TEKNOLOJI] your solution is faulty.

I bought your add-on because your trial version limits most label management actions. Follow all your steps to get rid of orphaned labels, yet the labels are still showing up on the "popular macros" heat map. 

Am I missing something, or are you deceiving customers?

Hi @David Castano,

If you can create ticket from link , we can try to resolve your problem.

However, this feature was developed after other customers request and it worked successfully.

Suggest an answer

Log in or Sign up to answer
Atlassian Community Anniversary

Happy Anniversary, Atlassian Community!

This community is celebrating its one-year anniversary and Atlassian co-founder Mike Cannon-Brookes has all the feels.

Read more
Community showcase
Kesha Thillainayagam
Posted Apr 13, 2018 in Confluence

We want to hear how your non-technical teams are using Confluence!

Hi Community! Kesha (kay-sha) from the Confluence marketing team here! Can you share stories with us on how your non-technical (think Marketing, Sales, HR, legal, etc.) teams are using Confluen...

357 views 20 10
Join discussion

Atlassian User Groups

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

Find a group

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

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you