robotsnoindex

This content applies to the legacy editor and the new editor.


Labels are key words that you can add to pages and attachments to make them easier to group and find. For example, you could add the recruiting label to all pages related to finding and hiring new talent. That would allow you to easily see, display, and search for related pages.

You can also use labels to categorize spaces. Head over to the page to learn more about using space labels to keep Confluence neat and organized.


Add labels to a page

Anyone with permission to edit a page can add labels to it. You can add labels to a page while you're editing it or after it's published, when you're viewing the page. If you add labels to a template, they will be added to new pages created from that template automatically. Space administrators can edit templates to add labels to them.

When you’re viewing a page

To add a label to a page you’re viewing:

  1. Select the label icon from the bottom of the page, above the page comments section). This will open the Labels dialog box (shown below).

  2. Enter the text of the label you’d like to add into the search box. If it matches any existing labels on your site, those will appear as suggestions in the dropdown.

  3. Select the label you’d like to add from the dropdown list or create a new label using the text you entered. For example, if you entered accounting in the search box, you would select the option to Create “accounting” from the dropdown to create a new accounting label.

  4. Repeat steps 1-3 to find and add additional labels to your page. Once you’re done, select Add.

When you're editing a page

To add a label to a page you’re editing:

  1. First, open the Labels dialog.

    1. In the new editor, select the more options menu in the top right of the page, then select Add labels.

    2. In the legacy editor, select the label icon from the top of the page you’re editing, to the right of the breadcrumb.

  2. Enter the text of the label you’d like to add into the search box. If it matches any existing labels on your site, those will appear as suggestions in the dropdown.

  3. Select the label you’d like to add from the dropdown list or create a new label using the text you entered. For example, if you entered accounting in the search box, you would select the option to Create “accounting” from the dropdown to create a new accounting label.

  4. Repeat steps 1-3 to add additional labels to your page. Once you’re done, select Add.

Add labels to attachments

To add labels to an attachment:

  1. First, open the page that contains the attachment you'd like to label.
  2. Select Actions menu icon to open the more options menu, then select Attachments.

  3. You'll see a list of attachments, with any existing labels listed in the Labels column.
  4. Select the edit icon  in the Labels column, next to the attachment you'd like to label. This will open the Labels dialog box.
  5. Enter the text of the label you’d like to add into the search box. If it matches any existing labels on your site, those will appear as suggestions in the dropdown.
  6. Select Add to create a new label using the text you entered. If you'd like to use one of the suggested labels, select it from the list, then select Add.
  7. Repeat steps 5-6 to add additional labels to your page. Once you’re done, select Close.

Labels do not accept spaces, and are lower case only. This means that you can type in multiple labels at once just by adding spaces between each label, and that any capitals will be automatically converted to lower case. If you want to use a label that has more than one word, try using a hyphen to separate them, like so: this-is-a-label.


Browse labels

One of the best things about using labels is that it makes it easy to find related pages. If you're on a page that has a label on it, all you need to do to find other pages with that label is click on the label! If you're new to a site or a space, however, you may not know which labels it uses. In this section, you'll learn how to access and use lists of labels.

Browse all labels for a space or site

To see all of the labels that are used in a space, enter a modified version of the following URL into your browser bar:

https://mysite.atlassian.net/wiki/labels/listlabels-alphaview.action?key=TCS

To modify the URL so it works for your site, replace mysite.atlassian.net with your site's domain details, and TCS with the space key for the space you're interested in.

You should see a list of labels that looks something like this:

To browse all of the labels for a site, select labels from all spaces from this page. You can also enter a modified version of this URL in your browser bar:

https://mysite.atlassian.net/wiki/labels/listlabels-alphaview.action

Just as before, you'll need to replace mysite.atlassian.net with your site's domain details.

Browse popular labels for a space or site

From the list of labels for a space or site, select the cog icon, then select Popular Labels. This will display labels in a word cloud. The bigger the font size of a label in the word cloud, the more popular it is for the relevant domain.

Search for labeled content by URL

To see all content on your site with a specified label, navigate to the Labeled content page. For example, to see everything with the label "documentation" on mysite.atlassian.com, you'd navigate to the following URL:

 https://mysite.atlassian.com/wiki/label/documentation

To see content with more than one specified labels, you need to include all labels in the URL and insert + between each of them. For example, to see all pages and attachments with the how-to label and the documentation label on mysite.atlassian.com, you'd navigate to the following URL:

https://mysite.atlassian.com/wiki/label/how-to+documentation

Remove labels

When you're viewing a page, you can remove labels by selecting the x to the right of the label. Labels appear on the bottom right of the page, above page comments.

To delete a label across a site, you'll need to remove it from all the pages and attachments it appears on.

If you have deleted pages that contain a label, you may need to purge the deleted pages from the space's trash to ensure that the label disappears too.

Use macros to categorize or display labels

Using labels with these macros, you can categorize pages, blogs, and attachments, and display them in Confluence in a number of ways:


From the Confluence blog