add-restriction macro

Overview

The {add-restriction} macro is used to add View or Edit content-level permissions.

When using the add-restriction macro the specified Confluence permission will be added to the users listed.

If there are other users who have Confluence permissions for the content but are not listed in the macro, these users will have their permissions restricted

Where to use it?

Optional.

One or more {add-restriction} macros can be put in a {trigger} macro.

If you want to remove these restrictions you can use the {remove-restriction} macro.

You can remove/add or add/remove restrictions using these macros in any order.

If you want to add restrictions immediately after removing restrictions of the same type, you can use the {set-restrictions} macro instead†.

Parameters

Parameter	Required	Default	Notes
type			What type of permission to set? view – assign the user/group view permission edit – assign the user/group edit permission
			Note: The permissions are set using Confluence's content-level permissions system and can thus be altered via the padlock icon.
user			One or more users to assign type permission to: Comma-separated list of usernames Supports Value References
group			One or more user groups to assign type permission to: Comma-separated list of user groups Supports Value References
At least one user or group must be specified. Both can also be used at the same time.
† In some cases, due to Confluence permission threads, rather than using {remove-restriction} macro then {add-restriction}, it may be useful to use {set-restrictions} macro. The {set-restrictions} macro will clear any existing restriction of the type being set (view or edit) before setting that permission for the listed users or groups.

Example

{workflow:Restrictions}
   {state:Test}
   {state}
   {trigger:pagecreated}
      {add-restriction:type=view|user=@user@|group=moderators}
   {trigger}
{workflow}

All examples

• Page:
  Add, remove and set page restrictions
• Page:
  Require Parameters on State Transitions — Require workflow parameter values to be set before moving into a workflow state.

See also

External Links:

• Page Restrictions

Workflow Authoring Guide:

• Conditions
• Roles and Permissions
• Value References
• {remove-restriction} macro
• {set-restrictions} macro