remove-restriction macro

Overview

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

Where to use it?

Optional.

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

If you want to add restrictions you can use the {add-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 remove? 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 remove type permission from: Comma-separated list of usernames Supports Value References
group			One or more user groups to remove type permission from: Comma-separated list of user groups Supports Value References
If neither user or group parameters are defined, then all content-level permissions of type will be removed.
† 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:Review|approved=Published}
      {approval:Review}
   {state}
   {state:Published}
   {state}
   {trigger:pageapproved|approval=Review}
      {remove-restriction:type=view}
      {remove-restriction:type=edit}
   {trigger}
{workflow}

All examples

• Page:
  Add, remove and set page restrictions
• Page:
  Restricting drafts to specific users using the add-restriction macro

See also

External Links:

• Page Restrictions

Workflow Authoring Guide:

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