🚀 New App Release! Permission Manager for Confluence Cloud is now available on the Atlassian Marketplace. Filter, audit, and bulk-manage page restrictions across your Confluence spaces - all built on Forge. Get started today: Permission Explorer & Manager for Confluence - Atlassian Marketplace

6. Bulk Label Operations in a Single Workflow

This guide explains how to update labels in bulk by following a single workflow. You can use the same process to add new labels, replace an existing label with another one, or remove labels that are no longer needed. The only part that changes is where you choose the target content: pages, live docs and blog posts are selected in Page Label Manager, while files are selected in Attachment Label Manager.

6.1 Choose an operation

First, decide what kind of label update you want to make. This choice controls which label fields the app shows in the next step, but it does not change the overall flow. You will still select labels, choose the content, review the summary, and confirm the operation.

Operation

When to use it

Add

Use Add when the selected pages, live docs, blog posts, or attachments should keep their current labels and receive one or more additional labels.

Replace

Use Replace to remove an old label from selected content and add a new one, leaving other labels unchanged.

Remove

Use Remove when selected labels should be deleted from the target items while all other labels remain on those items.

Screenshot 2026-07-30 134750.png
Fig 3. Operation selection

If you are not sure which option to choose, think about the result you expect after the operation finishes: add missing labels, rename or standardize a label, or clean up labels that should no longer be used.

6.2 Select labels

After you choose an operation, provide the labels the app needs to complete that action. The available fields change depending on the operation, so enter the values carefully before moving on.

Operation

Labels to enter

Add

Enter the label or labels that should be added to the selected content.

Replace

Select the old label that should be removed, then enter the new label that should replace it.

Remove

Enter the label or labels that should be removed from the selected content.

Screenshot 2026-07-30 134410.png
Fig 4. Label selection for Add operation
Screenshot 2026-07-30 134421.png
Fig 5. Label selection for the Replace operation
Screenshot 2026-07-30 134441.png
Fig 6. Label selection for the Remove operation

🏷️ Tips for selecting labels

  • Start typing a label name to see suggestions. If you spot the right one, just pick it.

  • You can also create a new label by typing a name that doesn’t exist yet.

  • If the item already has the label you’re adding, the app won’t add it again. It just skips it.

Labels don’t allow spaces and are all lowercase. If you type a space, it changes to a hyphen, so your label can have multiple words, like this: this-is-a-label. Capitals will switch to lowercase automatically. You can add several labels at once by pressing Enter or Return.

6.3 Select target content

Next, choose the content to receive the label update. The workflow is the same for all operations; the selection area depends on the content type.

  • Page Label Manager: Use the page tree to select the pages, live docs or blog posts to update.

  • Attachment Label Manager: Use the attachment list to select the files to update.

Screenshot 2026-07-30 134507.png
Fig 7. Content selection for Page Label Operations
Screenshot 2026-07-30 134521.png
Fig 8. Custom content selection for Page Label Operations
Screenshot 2026-07-30 135652.png
Fig 9. Content selection for Attachment Label Operations

6.4 Review and confirm

A summary table shows the full scope of the operation before anything is changed.

Column

What it shows

Operation

Add/Replace/Remove Bulk Labels

Selected content

Number of pages or attachments in scope, including any child pages

Label(s)

New or Old label(s) varying according to the operation

If anything looks wrong, click Back to adjust your selection. When ready, click Confirm.

Screenshot 2026-07-30 134542.png
Fig 10. Checking the selected operation, content, and labels

6.5 Start the operation

After confirming, a progress bar appears. The panel shows live details while the operation runs:

  • Operation Type: add / replace / remove

  • Page(s) to process: total pages / attachments being updated

  • Operation ID: unique reference for this job

  • Content type: page / attachment

If the app shows live progress or item-by-item updates, wait for the process to complete before leaving the page or repeating the action.

Screenshot 2026-07-30 134555.png
Fig 11. Operation details panel

6.6 Complete / Processing Results

Once complete, the results table appears:

Metric

Description

Total Processed

Total pages evaluated

Successful

Pages updated without error

Skipped

Contents skipped due to unsupported content type

Error

Pages that could not be updated

Screenshot 2026-07-30 134611.png
Fig 12. Complete step - Processing results

Click Close to dismiss the dialog.

There is no “Undo” feature in the application; actions cannot be reversed. You can correct mistakes using the following methods.

  • Reverse an Add operation by using Remove.

  • Reverse a Replace operation by replacing the new label with the previous label.

  • Reverse a Remove operation by adding the removed label again.

6.7 Example scenarios

The following short examples show typical use cases for each operation.

Operation

Example

Add

Add marketing and 2026-campaign to selected campaign pages.

Replace

Replace project-alpha with project-nova across selected content.

Remove

Remove draft from pages or attachments that are ready for publication.

Following this shared flow helps users perform bulk label updates consistently, whether they are working with pages, live docs, blog posts, or attachments.