add-restriction macro

Overview

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

Where to use it?

Optional.

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

If you want to add restrictions immediately after removing restrictions of the same type, 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.

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