This site has moved to the integrated Appfire documentation and information site for our apps.
From February 2024 this site is no longer updated.
Take a look here! If you have any questions please email support@appfire.com
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ā .
Restrictions don't give users permissions to content, but rather limit the users who have those permissions.
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, and everyone else just view the page.
Parameters
Parameter | Required | Default | Notes |
---|---|---|---|
| What type of permission to set?
| ||
Note: The permissions are set using Confluence's content-level permissions system and can thus be altered via the padlock icon. | |||
| One or more users to assign
| ||
| One or more user groups to assign
| ||
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Ā will clear any existing restriction of the type being set (view or edit) before setting that permission for the listed users or groups. Ā From v6.16.14+, when adding the |
Example
{workflow:Restrictions} {state:Test} {state} {trigger:pagecreated} {add-restriction:type=view|user=@user@|group=moderators} {trigger} {workflow}
All examples
See also
External Links: