Adding a label to a Confluence page takes about five seconds: Open the page, click the ‘Details’ icon in the bottom-right floating action bar, select ‘+’ next to Labels, type your label name, and hit ‘Enter’. Done.
That’s the quick answer. But if you manage a large Confluence site – one with hundreds of pages across multiple spaces – you’ve probably already hit the wall that is Confluence’s native labelling experience.
Because while adding a single label is easy, there’s no built-in way to add labels to multiple pages at once. For that, you’ll need a workaround or a Marketplace app.
In this guide, we’ll walk you through how labelling works in Confluence, how to add labels to one page or many, and the best approaches for teams who need to manage labels at scale.
What are Confluence labels?
Confluence labels are tags you can attach to pages, live docs, blog posts, and attachments to make them easier to find and group.
A few examples of how teams use labels in practice:
- Tagging policy documents as
confidentialorinternal-onlyto flag sensitivity level - Labelling pages as
draft,in-review, orapprovedas a lightweight status system - Grouping content by team, project, or product (e.g.,
marketing,q3-2025,product-roadmap) - Categorizing HR, IT, or compliance pages for easier cross-space search
Once a label is applied, you can:
- Search for it across a whole space or your entire Confluence site
- Display pages that share a label using macros like the Filter by Label, Content Report Table, or Popular Labels
- Quickly navigate between related content
Spotlight on labels and document management
Labels can be a valuable element of your document management system in Confluence, helping teams to track and categorize content.
With the Workflows for Confluence app, you can strengthen your document lifecycle processes further with automations and flexible workflows. From approving to publishing, Workflows for Confluence enhances visibility, document flow and compliance.
And you can use the app to automatically apply labels to documents in a workflow – reducing a heap of manual activity for your teams.
Worth taking a closer look? Start your free trial today!
How to add a label to a Confluence page
Here are the step-by-step instructions for adding a label to a page in Confluence Cloud:
- Open the page you want to label
- Select the Details icon in the bottom-right floating action bar
- Click + next to the Labels field
- Type your label name — Confluence will suggest existing labels as you type
- Press Enter to apply, then close the panel
A couple of things worth knowing:
- Labels are always lowercase
- Multi-word labels should use hyphens or underscores (e.g.,
in-revieworneeds_update) - Clicking a label at the bottom of any page shows you every other page on the site that shares it. This is handy for quick cross-referencing
You can also add labels while editing a page, and if you’re working from a template, any labels baked into that template will automatically apply to new pages created from it. Space Admins can edit templates to set this up.
Does Confluence Have a Way to Add Labels in Bulk?
This is where things get a bit frustrating.
At the time of writing, Confluence Cloud has no native bulk labelling feature. There’s actually a long-standing feature request for it – CONFCLOUD-17373 – so you’re definitely not alone in wanting it.
Note!
If you have the technical resource in-house, you could use the REST API for Confluence Cloud. If you’re still on Data Center*, meanwhile, you could use ScriptRunner instead.
For ease and speed, however, your best bet might be an Atlassian Marketplace app.
* A note that Atlassian Data Center products will reach end of life on March 28th 2029
Here’s a summary of your options:
| Approach | Works On | Requires |
|---|---|---|
| Manual (page by page) | Cloud, DC, Server | Nothing extra |
| Confluence Automation | Cloud | Automation rules set up in advance |
| REST API | Cloud, DC, Server | Technical knowledge |
| ScriptRunner | DC / Server | ScriptRunner app |
| Workflows for Confluence (created by AppFox) | Cloud | Installing the Workflows for Confluence Atlassian Marketplace app |
| Other Marketplace apps | Cloud, DC* | Third-party app |
* Again, a reminder here that Data Center Atlassian Marketplace apps will reach end of life on March 28th 2029.
How to add labels to multiple pages in Confluence Cloud (without doing it manually and losing your mind)
Option 1: Confluence automation
Confluence Cloud has a built-in automation engine that can apply labels to pages based on triggers and conditions. An example could be automatically labelling any new page created in a specific space, or labelling a page when its status changes.
This is great for keeping things consistent on an ongoing basis, but it doesn’t retroactively bulk-label existing pages (unless you set up a rule that runs across existing content).
Option 2: REST API
If your team has technical resource, the Confluence REST API lets you apply labels to pages programmatically. You’d query pages by space key or CQL (Confluence Query Language), then POST labels to each page’s content ID in turn.
It works – but it’s not a particularly user-friendly option, and maintaining scripts over time adds overhead.
Option 3: Workflows for Confluence
Now, ostensibly Workflows for Confluence is promoted as a document management, control and compliance tool. But it actually has some powerful label-related capabilities built in, too!
Let’s take a look at the key labelling features:
Add or remove labels as a workflow action Workflows for Confluence includes an Add or Remove Labels action that you can drop into any workflow stage. This means you can automatically add specific labels to a page once it reaches a certain point in its lifecycle. This could be tagging a page as approved once it clears a review stage, or removing a draft label when a document is published. You can also strip all existing labels from a page in one step before applying new ones.
Trigger workflows using labels (Auto-Assign) Working in the other direction, Workflows for Confluence can use existing page labels as a trigger. Using CQL (Confluence Query Language), you can configure the Auto-Assign feature to automatically apply a specific workflow to any newly created page that carries a particular label.
Use case for Auto-Assign label triggers
Say you’ve created a new page bearing the Confluence label label = "hr-policy". You can automatically apply a relevant workflow (‘HR Document Approval Workflow’, for example) to start flowing the page through the appropriate process.
This works particularly well alongside Confluence templates. If a template has a label pre-applied, any page created from it will inherit the workflow automatically.
Apply workflows to existing labelled pages in bulk Using the Bulk Change feature, you can target all existing pages that share a label via CQL and apply a workflow to them at once. This is useful when you’re rolling out a new process across a large body of content.
Option 4: Other Atlassian Marketplace Apps
For teams who only want pure label management without a full workflow layer, several other Marketplace apps exist specifically for bulk label operations in Confluence Cloud, offering point-and-click interfaces with no code required.
This is where the Atlassian ecosystem really shines. Wherever native Confluence functionality leaves a gap, there’s almost always a well-supported Marketplace app to fill it.
Why proper labelling matters more than you think
It’s easy to treat Confluence labels as a nice-to-have. But for teams managing compliance, documentation governance, or large knowledge bases, inconsistent labelling creates real problems:
- Visibility breaks down. Without consistent labels, pages get lost. Teams recreate content that already exists, or worse, rely on outdated versions.
- Compliance becomes harder. If you’re using labels to classify content by sensitivity (e.g.,
confidential,restricted), gaps in labelling mean gaps in your governance posture. - Audits get messy. When labels aren’t applied consistently, producing a clean audit trail of what content exists, who owns it, and what classification it carries is a painful manual exercise.
This is especially relevant for teams using Confluence as a central repository for policies, procedures, and regulated content — where document classification isn’t just helpful, it’s required.
Did you know?
If you’re using labels to manage data classification and content sensitivity in Confluence, Compliance for Confluence takes this a step further.
Rather than relying on manually applied labels, it gives admins centralized control over classification levels, with automated scanning and default classifications that apply the moment a page is created.
It’s a more robust, auditable approach than native labels alone – and you can try it free on the Atlassian Marketplace.
Frequently Asked Questions (FAQs)
Can I add the same label to all pages in a Confluence space? Not natively. You’d need to use Confluence Automation (Cloud), the REST API, ScriptRunner (Data Center), or a Marketplace app to apply labels across an entire space in one go.
What’s the difference between Confluence labels and page statuses? Page statuses (Cloud only) are a structured, admin-defined set of content states, like ‘Rough Draft’, ‘In Progress’ or ‘Ready for Review’. Labels are flexible, user-defined tags with no enforced structure. They serve different purposes: Satuses enable workflow and approval processes, whilst labels support search, navigation, and categorization.
Can I search by label across multiple spaces? Yes. Confluence’s search lets you filter by label across your entire site, not just within a single space. You can also use the Labels List macro to display all labels in a given space.
Are Confluence labels case-sensitive? No. Confluence automatically converts labels to lowercase, so Marketing, marketing, and MARKETING all resolve to the same label.
Can labels be added to attachments as well as pages? Yes. You can label attachments (files, images, etc.) stored in Confluence in addition to pages and blog posts.
What happens if I delete a label from all pages? In Confluence, labels don’t exist independently – they’re created by being added to a page for the first time, and effectively cease to exist once removed from every page they were applied to. There’s no central label registry to manage directly.
Is there a limit to how many labels I can add to a page? Atlassian doesn’t publish a hard limit, but best practice is to keep labels meaningful and consistent.
Wrapping Up
Adding a label to a single Confluence page is quick and intuitive. Scaling that across dozens or hundreds of pages is where the native experience falls short – and where a bit of automation or the right Marketplace app makes all the difference.
If you’re managing Confluence at scale and want more greater control over how content is classified and organized, it’s worth exploring what the Atlassian ecosystem has to offer beyond native labels.
To tie labelling into your broader document lifecycle management (such as automatically applying or removing labels as pages move through review and approval stages) Workflows for Confluence is built for exactly that.
And if data classification and compliance governance is on your radar, Compliance for Confluence takes things further still, with automated content scanning, centralized admin control, and default classifications that apply the moment a page is created.
Both are available on a free 30-day trial from the Atlassian Marketplace – so why not try them today!
