Assigning Space Permissions

You can assign space permissions to groups or to individual users. You need to be a space administrator to assign space permissions. In addition, Confluence administrators can set the default permissions that will be applied to new spaces as described below.

To access the permissions for a space:

  1. Go to the space and choose Space tools > Permissions on the sidebar.
  2. Choose Edit Permissions.

If your space is using the Documentation theme:

  1. Go to the 'Space Permissions' page:

    • Choose Browse > Space Admin at the top of the screen.Note: The 'Space Admin' option appears only if you have space admin permissions for the space or you have System Administrator global permissions.
    • Choose Permissions from the space administration options.
  2. Choose Edit Permissions.

The 'Edit Space Permissions' page is divided into the following sections:

  • Groups – a list of groups which already have permissions to access the site.
  • Individual Users – a list of users who already have permissions to access the site.
  • Anonymous Access – the space permissions granted to all anonymous users of the site.


Screenshot: Space permissions


Assigning space permissions to groups

  • To assign a permission, check the box next to the relevant group.
  • To deny a permission, uncheck the relevant box.
  • To add a new group to the list, type the group name into the text box in the 'Groups' section and choose Add. The group will appear in the list of groups. You can then assign the permissions.
  • To search for a group:
    • Choose the  icon.
    • The Group Search window opens. Enter all or part of the group name. You can use an asterisk '*' as a wild card.
    • Check the boxes to select the required group(s).
    • Choose Select Groups. The group name(s) will appear in the text box in the 'Groups' section.
    • Choose Add.
  • To bulk assign or revoke group member permissions, choose either Select All or Deselect All from the Actions dropdown list.

Choose Save All to apply the changes.

Assigning space permissions to users

  • To assign a permission, check the box next to the relevant user.
  • To deny a permission, uncheck the relevant box.
  • To add a new user to the list, type the username into the text box in the 'Individual Users' section and choose Add. The user will appear in the list of users, with 'View' permission assigned. You can then add more permissions if necessary.
  • To search for a user:
    • Choose the Magnifying glass icon.
    • The User Search window opens. You can read more about searching for users.
    • Check the boxes to select the required user(s).
    • Choose Select User(s). The username(s) will appear in the text box in the 'Individual Users' section.
    • Choose Add.
  • To bulk assign or revoke individual user permissions, choose either Select All or Deselect All from the Actions dropdown list.

Choose Save All to apply the changes.

Assigning space permissions to anonymous users

  • To assign a permission, check the box for the required permission.
  • To deny a permission, uncheck the relevant box.
  • To bulk assign or revoke anonymous user permissions, choose either Select All or Deselect All from the Actions dropdown list.

Choose Save All to apply the changes.

Note: You cannot grant space administration rights or page restriction rights to anonymous users.

Setting default space permissions

If you are a Confluence Administrator, you can set the default permissions that will be applied to new spaces. The default permissions are configurable for groups only, not for individual users or anonymous users.

To set the default space permissions:

  1. Choose the cog icon , then choose General Configuration under Confluence Administration.
  2. Choose Space Permissions under Security in the sidebar.
  3. Choose Edit Permissions.

Screenshot: Default space permissions


Managing and Recovering Space Admin Permissions

Users with System Administrator permissions are able to manage permissions for spaces, including adding or removing Space Admin permissions for a space.

To manage space permissions:

  1. Choose the cog icon , then choose General Configuration under Confluence Administration.
  2. Choose Space Permissions under Users & Security in the sidebar.
  3. Locate the space in the Individual Spaces list and choose Manage Permissions.

There may be some instances where a space administrator has removed Space Admin permissions from all other users and groups for a space, meaning that no other user can administer the space. Users with Confluence Administrator permissions can recover permissions for the space in this instance. 

To recover Space Admin permissions:

  1. Choose the cog icon , then choose General Configuration under Confluence Administration.
  2. Choose Space Permissions under Users & Security in the sidebar.
  3. Locate the space in the Individual Spaces list and choose Recover Permissions.

The user will then be able to choose Manage Permissions, and add any appropriate permissions to the space. Requests to recover permissions are recorded in the Confluence log files. 

Notes

Assigning permissions in bulk. There is no way to change a number of space permissions at once, via the Confluence user interface. Instead, take a look at the Confluence Command Line Interface. Here is a link to the CLI documentation. For an introduction to the CLI, see this blog post: Confluence CLI for bulk actions like deleting or publishing pages.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport