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. This page describes a few ways of viewing labels and labelled content. The focus of this page is on labels that are visible to everyone. You may also be interested in viewing personal labels.

Finding the labels view

Global labels are visible to all users with 'view' permission on the page, and personal labels are visible only to the person who added them.

  • Any page or blog post that has labels will have them listed together in a block at the bottom of the page.
  • You will also see labels in the 'Attachments' view or in a listing of attachments provided by the Attachments macro. (See Displaying a List of Attachments.)

To find the labels view by choosing a label:

If you are in a page that has labels, choose a label.

  • If it is a personal label (starts with 'my:') you will go to the personal labels page in your user profile. See Viewing Personal Labels.
  • If it is a global label, you will go to the 'Labels' tab of the space. Choose Popular Labels or All Labels to see all labels in the space.

Screenshot: Labels as they are displayed on a page


To find the labels view via URL:

Visit the following URL:

<MY.CONFLUENCE.SITE>/labels/listlabels-alphaview.action?key=MYSPACEKEY

 

For example: https://confluence.atlassian.com/labels/listlabels-alphaview.action?key=DOC

To find the labels view from the menu (Documentation theme only):

If the space is using the Documentation theme, you can access the labels view directly via the menu:

  • Go to a page in the space and choose Browse > Labels.
  • Choose Popular Labels or All Labels to see all labels in the space.

On this page:

Related pages:

Using the labels view

The labels view in a space offers the following options:

  • Popular Labels: Choose this option to see a list of the most frequently used labels in that space. From here, you can also view the most popular labels across the site. The bigger the font size, the more popular the label.
  • All Labels: View all labels in the space. From this view, you can choose a link to view an alphabetical listing of all labels across the site. Choosing a label will list all content in the space with that label. It will also display any related labels if they exist. Related labels are labels that frequently appear on pages together. For example, if pages labelled with 'sales' also tend to have the label 'marketing', these will be displayed as related labels.
  • See content from all spaces: Expand the list of labels to include pages and other labelled content from all spaces.

Screenshot: The labels view, showing all 'logo' labels 


Searching for labels

Use the 'labelText:' prefix to search specifically for content that has a specific label. The table below gives examples of search terms that you can enter into Confluence's search box, and the search results that you can expect.

Searching for ...

Returns content that ...

recipe labelText:chocolate

contains the word 'recipe' or has the label 'chocolate'

recipe AND labelText:chocolate

contains the word 'recipe' and has the label 'chocolate'

labelText:cake OR labelText:chocolate

has the label 'cake' or the label 'chocolate'

labelText:cake AND labelText:chocolate

has both labels 'cake' and 'chocolate'

The 'labelText:' prefix is an example of a search field. See more about Confluence Search Fields.

Navigating pages by URL and label

This section describes how to move around your Confluence pages by adding and subtracting labels from the list of labels that you want to match. You can search for matching labels by entering a URL. You can also add and subtract labels from the search.

To search labelled pages by typing a URL:

  1. Open a new web browser window.

  2. In the address bar of your web browser, type an URL such as:

    http://CONFLUENCE_HOSTNAME/label/foo+bar 

  3. Press Enter.

  4. The 'View Labels' page will load, showing search results for pages with the labels 'foo' and 'bar'.

Adding a label to your results:

  • Choose a label from the Related Labels list (at the top left).
  • A new page loads, showing pages that contain all of the labels selected so far. You can continue to add labels to the results in this way.

Subtracting a label from your search results:

When two labels are in use, links to subtract a label from the search appear at the end of the labels list. These are easily identified because these links have a preceding minus sign, like this:

- education
  • No labels

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.