🚀 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

2.2 Replace Bulk Labels

Swaps an existing label for a new one across selected pages. The old label is removed and the new label applied in a single step. All other labels on those pages remain untouched.

When to use: Renaming a misspelled or outdated label; rolling out a new taxonomy; updating all references when a project name changes.


Step 1 - Select Labels

This step has two fields:

Field

Purpose

Old Label(s)

Search for and select the label currently on your pages that you want to replace.

New Label(s)

Type or search for the label that should replace it. You can type a new name to create a label on the fly.

The Replace button is disabled until both fields contain a value.

image-20260617-101407.png
Fig 6 - The Replace Bulk Labels step with both fields empty (initial state).
image-20260617-101444.png
Fig 7 - Both fields filled: "a-test" will be replaced with "demo".

Click Replace to advance to Content Selection.


Step 2 - Content Selection

Works identically to the Add operation. The header confirms what is being replaced: Replacing Label(s): a-test → with → demo

Option

Behaviour

This content with its all child content

Applies the replacement to the current page and all its descendants.

Choose Content

Displays a page tree - check each page to include.

Click Next when your selection is ready.

image-20260617-101543.png
Fig 8 - Content Selection for the Replace operation with "Overview" checked.

Step 3 - Review & Confirm

The summary table includes an extra column compared to the Add operation:

Column

What it shows

Operation

Replace Bulk Labels

Selected content

Number of pages in scope, including child pages

Old Label(s)

The label being removed

New Label(s)

The label being applied in its place

Click Confirm to start the operation.

image-20260617-101807.png
Fig 9 - Review & Confirm showing "a-test" → "123" across 1 page.

Step 4 - Processing & Results

The progress screen shows the same metadata as the Add operation. You may also see a Calculating descendants… status message while the app determines how many child pages need to be updated.

image-20260617-101841.png
Fig 10 - Processing screen showing "Calculating descendants…" while child pages are counted.

Results follow the same format as Add (Total Processed / Successful / Error). Click Close when done.

image-20260617-101936.png
Fig 10a - Results screen.