Skip to main content

Add a label to parent pages

Label every page above one page, up to the space's top level, in a single run. On the Tools page, this is Add Label to Parent Pages.

Applies to: Script Master for Confluence Β· Cloud

Before you begin​

  • Confluence permission: permission to add labels to the pages above your page.
  • App permission: Add Label to Parent 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 Parent Pages.

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

  3. In Page, pick the page whose parents you want to label.

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

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

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

  6. Select Check pages. The report lists the first 10 target pages, from the top of the space down to the direct parent.

  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 parent pages, plus the selected page if you turned that on. Zero is a warning: a top-level page has no parents.
The label "name" will be added to eachThe lowercase label the tool writes.

What it changes​

ItemEffect
Parent pagesEach one gets the label. A page that already has it is unchanged.
The selected pageLabeled only when Also add the label to the selected page is on.
Child pagesUnchanged. Use Add a label to child pages for those.
Page bodies and versionsUnchanged.

The tool follows the chain of parents for up to 500 pages, reading one page at a time.

Undo a run​

The tool has no undo. Remove the label by hand, or swap it for another with Replace a label across content.