approval macro

Name of the content review.

• Within any {state} macro, each {approval} macro must be given a unique name
• The name can use any character set supported by your Confluence server – except some reserved characters.

Optionally define additional requirements which must be met prior to content approval – see: Conditions.

If one or more conditions are not met, the Approve/Reject buttons will be disabled. However, reviewer assignment will still be possible.

Can the user assign reviewers?

• true – Yes, they can assign reviewers
• false – No

Note: Assignees must have permission to edit the content and also be member of confluence-users group as a minimum. Other parameters relating to reviewers may enforce further restrictions.

To what extent do reviewers need to confirm their identity when reviewing?

• 0 – must be logged in (member of confluence-users group)
• 1 – additionally, must confirm Password
• 2 – additionally, must confirm Username

The requirements stack, so a value of 2 would mean: Logged in + Password + Username.

List users who are not allowed to review.

• A comma-separated list of usernames.
• Supports Value References (for example: @author@ to prevent content author from reviewing)

Note: While excluded users are not able to be assigned or Approve/Reject, they can still assign other users as reviewers where applicable (eg. if the assignable=true is used).

Reviewers must be a member of the specified user group(s):

• A comma-separated list of group names^‡
• Supports Value References

Note: Users who do not have Edit content permission will not be allowed to review.

Define the minimum number of reviewers required for the content review to be approved.

• Number ≥ 0
• Supports Value References (v4.18+)

Remember the assignees for reviews with this name?

• true – any subsequent reviews in the workflow that have the same name as this review (as defined by unnamed first parameter) will automatically have the same reviewers assigned ("sticky assignees")
• false – don't remember assignees

A single reviewer must be assigned from the list:

• A comma-separated list of usernames and/or group names
• Group names are treated as "a list of usernames"
• Supports Value References

Note: Users who do not have Edit content permission will not be allowed to review.

One or more reviewers must be assigned from the list:

• A comma-separated list of usernames and/or group names^‡
• Group names are treated as "a list of usernames"
• Supports Value References

Note: Users who do not have Edit content permission will not be allowed to review.

Reviewers must be in the specified list:

• A comma-separated list of usernames^‡
• Supports Value References

Note: Users who do not have Edit content permission will not be allowed to review.

Set the caption of the Approve button.

Set the caption of the Reject button.

When using multiple {approval} macros inside a single {state}, you can use this parameter to set the initial display order.

• Number ≥ 1
• Valid values in range of 1 → 232
• For best results, use multiples of 40.
• Items of the same weight will be ordered alphabetically A→Z
• Completed reviews will bubble to the top of the list, in order of completion

OBSOLETE Use the final parameter on the published {state} macro instead – see Publishing.

DEPRECATED Use the haslabel condition instead – see: Conditions.

Require that the page or blog has the specified label before a review can be made.