Skip to main content

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​

  1. Go to Apps > Script Master Tools, then select Add Label to Child Pages.

  2. In Space, type the space key and pick the space. The picker matches keys, not names.

  3. In Page, pick the page at the top of the branch.

  4. In Label, enter the label, for example needs-review.

    The Add Label to Child Pages form with a space, a page, the label needs-review, and the toggle for the selected page on

  5. To label the top page too, turn on Also add the label to the selected page.

  6. Select Check pages. The report lists the first 10 target pages.

  7. 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​

LineWhat it means
N pages will be labeledThe 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 includedThe branch is bigger. Pick a page further down and run the tool again.
The label "name" will be added to eachThe lowercase label the tool writes.

What it changes​

ItemEffect
Pages below the top pageEach one gets the label, at any depth. A page that already has it is unchanged.
The top pageLabeled only when Also add the label to the selected page is on.
Blog posts and attachmentsUnchanged. The tool labels pages only.
Parent pagesUnchanged. 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.