This documentation relates to Confluence 3.1.x
If you are using an earlier version, please view the previous versions of the Confluence documentation and select the relevant version.

Working with Labels Overview

Labels are user-defined tag words that can be assigned to pages and spaces. You can use labels to categorise, identify or bookmark content in Confluence.

For example, you can assign the label 'accounting' to all accounts-related pages on the site. You can then browse all pages with the label 'accounting' in an individual space or across the site, do a search based on it, and even use it to filter information when you subscribe to a Confluence RSS feed.

Because labels are user-defined, you can add any word (or even make up your own) that helps you identify the content in the site.

Labels can be added or removed without affecting the page content.

There are two different types of labels:

  • Global labels — see Adding a Global Label. A global label is available to all users across the site. Once a global label is added, any user with permission to view a page can also view its labels. Any user with permission to edit a page can add a global label to a page.
  • Personal labels — see Adding a Personal Label. A personal label is only available to the user that created it. Any user with 'view' permission can add a personal label to a page. The personal labels start with 'my:'.

The following screenshot shows the labels at the bottom of the page's content:



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 without having to restructure the site.
  • Labels are easy to add and edit, and do not affect the actual content of the page.
  • You can use labels to filter information during a search.
  • You can add as many labels as you like to a page.
  • The RSS feed builder allows you to create a news feed based on labels.
RELATED TOPICS
Label Macros
Viewing Global Labels
Categorising Wiki Content Using Labels
Related Labels Macro
Content by Label Macro
Navigating Pages by Label

Take me back to Confluence User's Guide

Labels

example example Delete
installation installation Delete
label label Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. Feb 18, 2008

    Emils Endele says:

    Hi, I wanted to know is there a way to filter by multiple labels. What I am lo...

    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. Feb 18, 2008

      Choy Li Tham says:

      Hi Emils, Unfortunately, Confluence does not provide this feature currently and...

      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.

      Regards,
      Choy Li

      1. Feb 19, 2008

        Emils Endele says:

        hi Choy Li, Thanks for the info. I looked at some extensions but couldn't find ...

        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.

         Emils

  2. Mar 10, 2008

    Greg Flanagan says:

    Does anyone have suggestions for multi-word labels? meetingnotes meeting+notes ...

    Does anyone have suggestions for multi-word labels?

    meetingnotes
    meeting+notes
    meeting notes

    1. Mar 10, 2008

      Choy Li Tham says:

      Hi Greg, I have found an improvement request, which is currently being tracked ...

      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.

      Regards,
      Choy Li

  3. Apr 23, 2008

    Mark says:

    Can you guys add the JIRA buglist for labels directly on this page - I think if ...

    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. Feb 05, 2009

    Joe Benfield says:

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

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

    1. Feb 17, 2009

      Azwandi Mohd Aris [Atlassian] says:

      You might want to check out the Label Tools Plugin which provides a macro to ena...

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

  5. Sep 15

    anthony hornby says:

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

    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

Add Comment