4. Quick Reference

4.1 Operation Comparison

Operation	Adds labels	Removes old label	Preserves other labels	Supports child pages
Add Bulk Labels	✅	❌	✅	✅
Replace Bulk Labels	✅	✅	✅	✅
Remove Bulk Labels	❌	✅	✅	✅

4.2 Content Selection Options

Option	When to use
This content with its all child content	You want to apply the operation to the entire page hierarchy below the current page - no manual selection needed.
Choose Content	You want to pick specific pages from a tree, or include some child pages but not others.

Tip: When re-labeling an entire project section, select the top-level page and use This content with its all child content - the operation cascades through all descendants automatically.

4.3 Processing Results Reference

Result	Colour	Meaning
Total Processed	Blue	Total pages or attachments evaluated during the operation.
Successful	Green	Items updated without any problem.
Skipped	Yellow	Items the label wasn't found on (Remove only), or items outside your edit permissions. Expand the row with › for details.
Error	Red	Items that failed to process. Expand the row with › for the error detail.

4.4 Label Naming Rules

Rule	Detail
Case-sensitive	`project-alpha` and `Project-Alpha` are treated as different labels.
Allowed characters	Letters, numbers, hyphens ( `-` ), and underscores ( `_` ). Spaces are not permitted.
Maximum length	255 characters.
Duplicates	If a label already exists on an item, it is not duplicated - the item is counted as successful and the operation continues.
Scope	Labels are space-scoped in Confluence. The same label name in different spaces is independent.

4.5 Best Practices

Use Replace instead of Remove + Add. For renaming a label, Replace Bulk Labels is a single atomic step - faster and cleaner than running two separate operations.

Test on a small selection first. Run the operation on a handful of pages before applying to the whole space to confirm the result matches your expectation.

Use "Choose Content" carefully on large spaces. Selecting a top-level page with many descendants can affect hundreds of pages. Review the Review & Confirm summary before clicking Confirm.

Check the results table after every run. Skipped and Error rows expand to show which pages were affected - handle any failures manually if needed.

Document your operations. Record what was changed, by whom, and when - particularly useful for team awareness or compliance.