---
title: "remove-restriction macro"
canonical: "https://support.appfire.com/space/CDML/649957267/remove-restriction%20macro"
format: markdown
---
> Macro (aura-html)


## Overview

> Macro (excerpt)
> 
> Remove content view/edit permissions

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](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649859133).

This macro removes restriction limits that has been set for the permission on the page.

> 📝 The app [add-restriction](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649793069) and [set-restrictions](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649662496) macros do not 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 the named users can edit the page. Everyone else can only view the page.

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](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649662496) instead.†

> ℹ️ If you want to add restrictions you can use the [add-restriction macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649793069).

## Parameters

|  |  |  |  |
| --- | --- | --- | --- |
| **Parameter** | **Required** | **Default** | **Notes** |
| `type` | :check_mark: |  | What type of permission to remove?<br>- `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` | :info: |  | One or more users to remove `type` permission from:<br>- Comma-separated list of usernames
- Supports [Value References](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649694302) |
| `group` | :info: |  | One or more user groups to remove `type` permission from:<br>- Comma-separated list of user groups
- Supports [Value References](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649694302) |
| :info: 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 the [add-restriction](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649793069) macro, it may be useful to use [set-restrictions macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649662496).<br>> ℹ️ The [set-restrictions macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649662496) clears any existing restriction of the type being set (**view** or **edit**) before setting that permission for the listed users or groups. |

## Example

```plaintext
{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}
```

If the workflow is applied to a blog post, a trigger must use the appropriate event for a blog post. For example, the `newsapproved` event

```plaintext
{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}
   {trigger:newsapproved|approval=Review}
      {remove-restriction:type=view}
      {remove-restriction:type=edit}
   {trigger}
{workflow}
```

## All examples

> Macro (contentbylabel)

## See also

External Links

- [Page Restrictions](https://confluence.atlassian.com/doc/page-restrictions-139414.html)

[Workflow Authoring Guide](https://appfire.atlassian.net/wiki/spaces/CDML/pages/648611901)

- [Conditions](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649694110)
- [Roles and Permissions](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650217543)
- [Value References](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649694302)
- [add-restriction macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649793069)
- [set-restrictions macro](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649662496)