Adding Labels

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.

Labelling a page or blog post

Any user with permission to edit a page can add a label to a page.

To add a label to a page or blog post:

  1. Go to the page. If the page already has labels, these will be listed at the bottom of the page, below the page content.
  2. Choose the edit icon  beside the list of labels, or press L on your keyboard.
  3. Type in a new label. Existing labels are suggested as you type.
  4. Choose Add.

Screenshot: Labels as they are displayed on a page

Screenshot: Adding a label to a page or blog post

Labelling an attachment

If you have permission to view or edit the page that contains the attachment, you can add a label to the attachment.

To add a label to an attachment:

  1. Go to the page that contains the attachment. Choose Tools > Attachments.
  2. Alternatively, go to the attachments view of the space:
    • Go to the space and choose Space tools > Content Tools on the sidebar. 
    • Choose Attachments.
  3. You will see a list of attachments, with columns for attachment name and other details. If the attachment already has labels, these will be listed in the Labels column.
  4. Choose the edit icon  beside the list of labels.
  5. Type in a new label. Existing labels are suggested as you type.
  6. 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.

Screenshot 2: Adding a label to an attachment


  • Note: Personal labels are deprecated. Earlier versions of Confluence recognised a special type of label called a 'personal' label. A personal label starts with 'my:' and is only visible to the user who created it. We are removing personal labels from Confluence, as announced in the Confluence 4.1 Upgrade Notes. The functionality for personal labels is still in Confluence, but we recommend that you stop using them. In a future release, we plan to remove the functionality altogether.
  • If you add a label to a template, that label will be copied to the page when someone adds a page based on that template. See Adding a Template.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport