Add a label to child pages
Label every page below one page, at any depth, in a single run. On the Tools page, this is Add Label to Child Pages.
Applies to: Script Master for Confluence Β· Cloud
Before you beginβ
- Confluence permission: permission to add labels to the pages below your page.
- App permission: Add Label to Child Pages is available to you. It's available to all users unless an admin changed that. See Set who can use each tool.
The label can use lowercase letters, numbers, hyphens and underscores, up to 255 characters.
Add the labelβ
-
Go to Apps > Script Master Tools, then select Add Label to Child Pages.
-
In Space, type the space key and pick the space. The picker matches keys, not names.
-
In Page, pick the page at the top of the branch.
-
In Label, enter the label, for example
needs-review.
-
To label the top page too, turn on Also add the label to the selected page.
-
Select Check pages. The report lists the first 10 target pages.
-
Select Add label.
Result: Label added says how many pages changed, and lists up to 10 failures with the reason for each.
What the check tells youβ
| Line | What it means |
|---|---|
| N pages will be labeled | The pages below, plus the top page if you turned that on. Zero is a warning: the page has no children. |
| Only the first 5,000 pages are included | The branch is bigger. Pick a page further down and run the tool again. |
| The label "name" will be added to each | The lowercase label the tool writes. |
What it changesβ
| Item | Effect |
|---|---|
| Pages below the top page | Each one gets the label, at any depth. A page that already has it is unchanged. |
| The top page | Labeled only when Also add the label to the selected page is on. |
| Blog posts and attachments | Unchanged. The tool labels pages only. |
| Parent pages | Unchanged. Use Add a label to parent pages for those. |
Undo a runβ
The tool has no undo. Remove the label by hand, or swap it for another with Replace a label across content.
Relatedβ
- Add a label to parent pages: the other direction, up the tree.
- Tools limits and behavior: the cap, retries and partial failures.
- Tools: every tool and how a run works.