Set up Confluence Cloud
Get the high-level details you need to set up your Confluence Cloud site in order to meet your team's needs.
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 and keep Confluence neat and organized.
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.
To add a label to a page you’re viewing:
Select the label icon from the bottom of the page, above the page comments section). This will open the Labels dialog box (shown below).
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.
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.
Repeat steps 1-3 to find and add additional labels to your page. Once you’re done, select Add.
To add a label to a page you’re editing:
First, open the Labels dialog.
In the new editor, select the more options menu in the top right of the page, then select Add labels.
In the legacy editor, select the label icon from the top of the page you’re editing, to the right of the breadcrumb.
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.
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.
Repeat steps 1-3 to add additional labels to your page. Once you’re done, select Add.
To add labels to an attachment:
First, open the page that contains the attachment you'd like to label.
Select to open the more options menu, then select Attachments.
You'll see a list of attachments, with any existing labels listed in the Labels column.
Select the edit icon in the Labels column, next to the attachment you'd like to label. This will open the Labels dialog box.
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.
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.
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.
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.
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.
From the list of labels for a space or site, select , then 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.
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
When you're viewing a page, you can remove labels by selecting the 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.
Using labels with these macros, you can categorize pages, blogs, and attachments, and display them in Confluence in a number of ways:
Content by label macro: lists all content with a specified label or labels.
Content report table macro: displays information about pages and blog posts with a specified label in a table.
Labels list macro: lists all labels in a space alphabetically.
Navigation map macro: renders the list of pages associated with a specified label as a navigation map.
Popular labels macro: displays popular labels as a word cloud.
Recently used labels macro: lists labels that have been used recently.
Related labels macro: lists other labels associated with the label you're viewing.
Was this helpful?