set-label macro

Overview

The set-label macro is used to add a label to content – either the current page or the immediate child pages.

Where to use it?

Optional.

One or more set-label macros can be put in a trigger macro.

Parameters

Parameter	Required	Default	Notes

Parameter

Required

Default

Notes

unnamed first parameter
or label

Name of label to add

supports Value References (v4.4.1+)

Name can use any character set supported by your Confluence server – except some reserved characters

children

false

What should the label be applied to?

true – all immediate children of the page, but not the page itself^†
false – the page or blog post itself

^† Only works for pages, not blog posts. Use with caution!

Conditions

The following conditions are applicable to labels

haslabel
parenthaslabel

Events

The following events are generated by this macro

labeladded

Example

{workflow:Labelled}
   {state:Editing|submit=Review}
   {state}
   {state:Review}
   {state}
   {trigger:statechanged|state=Review}
      {set-label:being-reviewed}
   {trigger}
{workflow}

All examples

Page:

Add a label to child pages — Triggers to add a label to page using a pagecreated trigger with either a parenthaslabel or a ischildof condition