🚀 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

3.2 Replace Bulk Labels

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

When to use: Renaming a label on uploaded files; rolling out a new taxonomy across attachments.

Step 1 - Select Labels

Field

Purpose

Old Label(s)

The label currently on the attachments that you want to replace.

New Label(s)

The label that should replace it. Type a new name to create it on the fly.

The Replace button is disabled until both fields have a value. Click Replace to advance.

image-20260617-143116.png
Fig 6 - Replace Bulk Labels with "demo" as the old label and "demonstration" as the new label.

Step 2 - Content Selection

The attachment list shows the current labels on each file. The header confirms the replacement being made: Replacing Label(s): demo → with → demonstration

Check each attachment the replacement should apply to, then click Next.

image-20260617-143159.png
Fig 7 - Content Selection for the Replace operation. The attachment shows "demo", "fromapp", "88888" as its current labels.

Step 3 - Review & Confirm

Column

What it shows

Operation

Replace Bulk Labels

Selected content

Number of attachments in scope

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-143232.png
Fig 8 - Review & Confirm showing "demo" → "demonstration" across 1 attachment.

Step 4 - Processing & Results

The progress screen shows the same metadata as the Add operation, with Content Type: attachment and Attachment(s) to Process as the page count label.

image-20260617-143303.png
Fig 9 - Processing screen for the Replace operation showing "Calculating descendants…"

Results show Total Processed, Successful, and Error. Click Close when done.

image-20260617-143331.png
Fig 10 - Processing Results: 1 attachment updated, "demo" replaced with "demonstration", 0 errors