Page Comparison

Overview

The add-restriction macro is used to add view or edit content-level permissions.

When using the the add-restriction macro the  macro the specified Confluence permission will be added permissions are restricted 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

For example, if everyone has edit/view permissions for the space and you add edit restrictions to a page - for user A and user B - only user A and user B can edit the page. Everyone else is only able to view the page.

Where to use it?

Optional.

One or more add-restriction macros can be put in a trigger macrotrigger 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†.

...

Restrictions don't give users permissions to content, but rather limit the users who have those permissions.

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
Info

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

, as itwill clear

. This macro clears any existing restriction of the type being set (view or edit) before setting that permission for the listed users or groups.

 From

From v6.16.14+, when adding the add-restrictions macro to a trigger, any an invalid user/group (disabled/deleted user) will be ignored and restrictions will be set for the defined valid users.

Example

The following examples restrict view permission to

• the user who created the page

• users who are members of the Confluence user group moderators

Adding a view restriction on creating a new page:

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

Adding a view restriction on creating a new blog post:

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

Adding a view restriction on creating a new blog post or a new page requires both the above triggers in the applied workflow:

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

The restrictions can then be removed, for example, on approving the content

{workflow:Restrictions}
   {state:Draft|approved=Published}
   {approval=Publish|group=moderators|minimimum=2}
   {state}
   {state:Published|final=true|updated=Draft}
   {state}
   {trigger:newscreated}
      {add-restriction:type=view|user=@user@|group=moderators}
   {trigger}
   {trigger:pagecreated}
      {add-restriction:type=view|user=@user@|group=moderators}
   {trigger}
   {trigger:pageapproved}
      {remove-restriction:type=view}
   {trigger}
   {trigger:newsapproved}
     {remove-restriction:type=view}
   {trigger}
{workflow}

All examples

See also

External Links:

• Page Restrictions

Workflow Authoring Guide:

• Conditions

• Roles and Permissions

• Value References

• remove-

  restriction macro

  restriction macro

• set-restrictions macro