Add, Remove and Search for Labels
- Go to the page choose the edit icon beside the list of labels or press L on your keyboard
- Type in a new label (existing labels are suggested as you type)
- Choose Add
If you're editing or creating a page, and you want to add labels, choose the label iconat the top of the page.
Label an attachment
- Do either of the following:
- Go to the page that contains the attachment and choose Go to > Attachments
- Go to the space and choose Space tools > Content Tools from the bottom of the sidebar, then choose Attachments
- Choose the edit icon beside the list of labels and type in a new label (existing labels are suggested as you type)
- Choose Add
You can also add labels in a list of attachments displayed by the Attachments macro, by choosing the edit icon beside each label.
If you add one or more labels to a template, that label will be copied to the page when someone adds a page based on that template. See Creating a Template.
The Labelled content page
If you're viewing a page or post that has labels or displays the Attachments macro, you can choose any label to go to the Labelled content page for the space. Choose Popular Labels or All Labels from the cog at the top-right – to view the most-used labels or all labels in the space – or choose See content from all spaces from the cog to view labelled content from all spaces in your Confluence site.
Screenshot: The Labelled content page
The Popular Labels option displays a word cloud, where the bigger a label is displayed, the more popular it is. Choose any label to view content tagged with that label.
You can also navigate to the labels view for a space by entering the following URL (replace SPACEKEY with the space's key):
If the space is using the Documentation theme, access the Labelled content page by choosing Browse > Labels
Search by label
You can use the '
labelText:' prefix to search specifically for content that has a specific label. For example, if you're looking for pages with the label 'chocolate', type
labelText:chocolate into the search field in the Confluence header. For more examples of searching by label, see Confluence Search Syntax.
Search for labelled pages using a URL
Entering a URL with an appended label or labels is another way to search for pages with particular labels.
In your browser's address bar, enter the following URL and press enter: http://<your.Confluence.site>/label/foo+bar
The Labelled content page will load, showing search results for pages with the both labels, 'foo' and 'bar'. Replace 'foo' and 'bar' with the label(s) you want to search for, and separate multiple labels with a
Adding a label to your results:
Once you're on the Labelled content page, you can add more labels to your search by choosing them from the Related Labels list at the top-right of the page. Each label is listed with a plus (+) sign.
If you want to remove labels from your search, locate the included labels at the top of the page and choose the label(s) you want to remove. Each included label will be listed with a minus (–) sign.
When viewing page, blog post, or attachment labels, an x appears alongside each label. Choose the x to remove the label.
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.