Documentation for Confluence 5.4.
Documentation for Confluence OnDemand and earlier versions of Confluence is available too.

Skip to end of metadata
Go to start of metadata

Labels are key words or tags that you can add to pages, blog posts, attachments and spaces. You can define your own labels and use them to categorise, identify or bookmark content in Confluence.

For example, you could assign the label 'accounting' to all accounts-related pages on the site. You can then browse all pages with that label in a single space or across the site, or display a list of pages with that label. You can search based on the label, or use it to filter items when you subscribe to a Confluence RSS feed.

Because labels are user-defined, you can add any word that helps you identify the content in the site.

You can add or remove labels without affecting the page content.

Content labels

You can add labels to pages, blog posts and attachments. Any user with permission to view the page can also view its labels. See Adding Labels.

Space categories

You can also apply labels to spaces and use them to categorise your spaces. These are known as space categories. See Using Labels to Categorise Spaces.

On this page:

Related pages:

Advantages of labels

Here are some of the advantages of using labels:

  • Labels are user-defined which means that you decide what information is relevant to you and how you are going to label it.
  • You can group pages and spaces without having to restructure the site.
  • Labels are easy to add and edit, and do not affect the content of the page.
  • You can add as many labels as you like to a page or space.

Using labels


Note: Personal labels are deprecated: Earlier versions of Confluence recognised a special type of label called a 'personal' label. A personal label starts with 'my:' and is only visible to the user who created it. We are removing personal labels from Confluence, as announced in the Confluence 4.1 Upgrade Notes. The functionality for personal labels is still in Confluence, but we recommend that you stop using them. In a future release, we plan to remove the functionality altogether.



  1. Hi,

    I wanted to know is there a way to filter by multiple labels.

    What I am looking for is change the way how related labels are handled. Basically when I click on a related label I want search to return results that include both labels and not just the related one.

    Is there any plugin that can do it or a way to enable it by default?

    tnx in advance 

    1. Hi Emils,

      Unfortunately, Confluence does not provide this feature currently and there is no plugin/macro that I can think of to fulfill your request. Perhaps, you may want to give a try to search for other plugins in our Confluence Extension space which might meet your requirement.

      If the above is not an option to you, I have found a similar feature request which stated to filter by multiple labels in Confluence at the following:

      If you are keen on this feature, please do cast your vote to increase its popularity and add yourself as a watcher to the issue above for future updates. Also, feel free to add comments to the feature to reflect the importance of this feature.

      Choy Li

      1. hi Choy Li,

        Thanks for the info. I looked at some extensions but couldn't find anything that suited the best. However the link to JIRA seems promising. it shows that feature is scheduled for 2.8 version, so it is something to look forward to.


  2. Does anyone have suggestions for multi-word labels?

    meeting notes

    1. Hi Greg,

      I have found an improvement request, which is currently being tracked at the following link:

      The improvement request above stated that Confluence should support the functionality of multi-word labels. Additionally, there are workaround suggested within the improvement request that you might want to give a try such as using "meeting_notes" and "meeting-notes". Meanwhile, if you are keen on this improvement, feel free to cast a vote to increase its popularity and add yourself as a watcher. Also, you may want to add a comment to the improvement request to share your concern regarding this issue with the participant within the improvement request.

      Choy Li

    2. Anonymous

      I believe using underscore character is the best.

  3. Can you guys add the JIRA buglist for labels directly on this page - I think if Altassian did that for all its pages it would greatly reduce questions and focus the activity on the features/bugs

  4. Is there a way to feed specific page content or form variables into the labels field?

    1. You might want to check out the Label Tools Plugin which provides a macro to enable automatic labelling

      1. Anonymous

        Do you know if Label Tools is compatible with Confluence 3.1/3.2?

  5. Is it possible to bulk edit / bulk merge labels in confluence 3.0?

    Specifically I want to be able to clean up labels in the wiki from time to time and cascade change this for all labelled pages (we will have a large site and editing them all by hand isn't feasible).

    e.g. some staff have labelled things "project" and others "projects"  how do we merge these into "project" and update all labelled pages/bookmarks?

    Alternately we decide a label is just not needed - how do we get rid of it from all content in one go?

    If this can only be done at the database level currently I am interested in knowing how that would be done (what database tables are affected / any caveats or things to be wary of.

    We want to make sure that the labelling stays ordered and doesn't get out of hand as we intend to use labels to group and order content a lot.

    All help appreciated :-)

    Regards Anthony

    1. Anonymous

      Any response to this? I too am interested in bulk editing labels, for example, in a manner similar to managing a gmail label.

    2. I also am interested in this.

  6. Anonymous


    Can we make labels mandatory when creating a page.  We have some of the spaces wanting to use this feature.

    1. Hi,

      I have a mere suggestion, you might want to create a space template with labels. During creating a new page just use the space template. To learn more on how to create the page template, please refer to the following documentation:

      Hope that helps.

  7. Is there a way to enforce using tag name spaces / fix prefixes?

    Like "my:" prefix is used for personal tags, it could be useful to have prefixes "customer:", "project:", "technique:", "skill:", etc. to allow multiple categories where tags can be used in different context.

    E.g. I could have on my personal page a list of tags describing my skills using the skill-prefix, for example "skill:hibernate, skill:java, skill:wicket, skill:struts, ..." and a project could be tagged with a list of techniques being used like "technique:java, technique:db2, technique:esb, ...".

    Such namespaces would allow to search independent for people with a certain skill and projects utilizing a certain technique even when same tags is used (skill:java vs. technique:java)...

    So, is it possible to do this?



  8. Is it possible to enhance the existing label system in Confluence with a plugin?

    What we want to do is to add some label suggestions to the existing ones. This should also be possible if on is using the autosuggest input field. Therefore we have to get the pages text, send it to a remote Web Service.

    If it is not possible to modify or enhance the existing internal labelling system - is it otherwise possible to modify the default page template from a plugin to add a completly new input field?

    Kind regards

    1. Hi there Thomas,

      Unfortunately I can't help you with questions about developing new Confluence plugins.

      For more information, why not post a question under Confluence development topics on Atlassian Answers or create a feature request on our issue tracker for the Confluence developers?

      Alternatively, you could always open a support request at, where our support engineers will be able to get back to you quickly.

      I hope this helps.

      Best Regards,

      Edwin Dawson
      Technical Writing Team Leader

  9. In 2.9x, it appears that personal labels are not used to affect searches. I created personal label "montypython" and applied it to a page. When I used montypython as a search term, no results were found.

    The wording in the 3.5x documentation is a bit ambiguous regarding this feature, but it looks like personal labels may be able to be used as search terms in that version. Is this the case?

  10. Anonymous

    I'd like a feature where I could highlight a word in the text and make it a label.

  11. Hi, 

    Is there a way to make it so certain labels are linked - so if I add label A, label B will also be added automatically. Basically we have a large label database and we are finding that many things are called slightly different things by different people and so we were hoping to clean this up by linking them so they come up together on a page. 

    Any thoughts?



  12. Hi all,

    I'm looking for a way to automatically apply a label to all sub-documents of a given document. For example, if Status Updates is a  document at the top level of a Confluence Space, I'd like all Child Pages created under the Status Updates page to have the label status_update applied automatically.

    Anyone know of a way to do this?

    Thanks in advance.

    1. Bob WorobecBob Worobec - there is no way to do this in Confluence out-of-the-box.

      You may want to create a feature request on our public issue tracker:

      Ad Hoc Canvas, an add-on on the Atlassian Marketplace, may be helpful managing your labels in Confluence:

  13. Anonymous

    Is there any way to hide labels from users? I want to use labels to track certain pages, but I don't want that label to display on the page for most users.

    Thank you.

  14. Anonymous


    The label field appears when raising a bug, I assumed that if this field appears then the user can create a search for bugs that use a particular label. For example, when raising a bug I create a label called 'test'. I would then like to go to issue navigator and search for all bugs containing the label 'test'. However when trying to create a search, I try to select the 'label' field using the 'more criteria' field however I find that I am unable to select and therefore search on the 'label' field.

    1. Hallo there

      It sounds as if you're working with JIRA, not Confluence? If so, here's the JIRA documentation on labels:

      Cheers, Sarah

  15. Hi,

    If the page is creted, how aboutadding the space name as one of the label to the page.

    Is there any way to do that.


  16. I'm just wondering that Atlassian sets the personal labels concept to deprecated:

    We are using personal labels to make our CF dashboard more personalized (bookmarks, page favourites adjustable per user).This is working fine even if there are some bugs (e.g. personal labels will be removed if the content is updated by someone other).

    So please tell me why Atlassian decided to drop this feature?

    And will there be any successor for this concept (Confluence's page favourites rely on this too)?

    Thank you in advance!


    1. Hallo Uwe

      Thanks so much for telling us how you use personal labels. It's useful to know of real use cases for the feature. I'll forward this comment to the Confluence product managers for their input.

      Cheers, Sarah

      1. Hello Sarah Maddox [Atlassian],

        the Atlassian support recently adviced me to upgrade our wiki to CF 5.x. One of the biggest problem (w/o any further analysis) would be how to cope with the dropped personal label feature since some solutions in our wiki rely on that.

        So my question to you is if there is any feedback from your product managers regarding my input one year ago?

        Best regards, Uwe

  17. Hi,

    How can I do searching for label without labelText: ?

    1. I have the same need. I want to be able to find all pages in a space that are not labeled. One way that might work is if there were a way to apply a label to all pages in a space. If all pages had a <spacename> label, then we could use the current labeling functionality to find those pages that have the <spacename> label only (and not the others). Then we could add the appropriate label to each of those pages.

  18. It would be great if we could force users to comply to adding labels to new pages... non labelled pages really are frustrating.

  19. Hi,

    Is it possible to write a script to change the label of a page or properties macro?  I want to be able to easily change a label from active to complete with a click of a button. 


  20. Anonymous

    Is it possible to label a word instead of a whole page? I want to label certain words throughout an entire space. Then when I use "content by label," I want it to list / link to the various words throughout the whole space (not the name of the page). I guess I'm thinking along the lines of tags... or like an index (but manually choosing the topics, rather than allowing the index macro to automatically grab every single heading).

  21. Not sure if this is the right place for this question but...

    is there any way to apply a label to a page and all its children ? I'm looking for some way to conveniently show all the changes of a chunk of related content that is too much for a single page. "recently updated" does the trick IF all the pages have the same label.


    Maybe a bridge too far but would be great if a tag can be locked to a particular version of the page (a la source control tools like git/svn) so the appropriate version of the child for a particular version of the parent is obvious (smile)