Breadcrumbs

Minimum Permissions for Custom Roles and Access

Atlassian is slowly rolling out roles to Confluence, replacing the original space permissions.

In this article, you’ll learn the minimum permissions required to perform specific Scroll Documents actions using custom roles or custom access.

Please note

Since roles is a new beta feature in Confluence, the roles and permissions needed for certain actions may change as the feature is updated. If you notice somethings has changed since last time we updated this article, don't hesitate to contact our support.

Last updated:

Difference Between Default Roles, Custom Roles, and Custom Access

Confluence provides the following default roles to manage actions at the space level:

  • Viewer

  • Collaborator

  • Manager

  • Admin

Each default role includes a predefined set of role permissions with actions that users can perform within the space which you can find documented.

You can assign a user or group one of these default roles or provide custom access by manually selecting specific permissions outside of the presets. You can also create custom roles to use as templates, if you want to reuse the same combination of permissions several times.

You can manage role permissions for a space within the Users section of your Space settings, or under Security within the Confluence administration screen. For more information on roles, refer to the Confluence documentation: Manage user roles

Proceed to the next section to learn the minimum role permissions required for specific Scroll Document actions.

If you prefer using default roles, the following article provides a detailed table of the actions each role can perform in Scroll Documents: Assign the Required Roles

Which Role Permissions Are Required for Specific Scroll Documents Actions?

If you want to set up a custom role or give a user custom access to a space, you can see what role permission they need below for what actions:

Scroll Documents action

Minimum role permissions needed

Create a document

  • View content

  • Create content

  • Edit content

  • Add attachments

Edit document details

  • View content

  • Create content

Delete a document

  • View content

  • Delete anyone’s content

  • Delete attachments

  • Create content

Move a document

  • Manage everything in space

  • Manage all content in space

  • View content

  • Create content

Save a version

  • View content

  • Create content

  • Edit content

  • Delete anyone's content

  • Manage access to individual content

Before saving a version, ensure the user has view and edit access to all pages that the new version is based on (usually the Working version).

Edit version details

  • View content

  • Create content

Delete a version

  • View content

  • Create content

  • Delete anyone's content

  • Delete attachments

Copy a version

  • View content

  • Create content

  • Edit content

  • Manage access to individual content

Use Organize page tree

  • View content

  • Create content

  • Delete anyone's content

Use Add existing page tree

  • View content

  • Create content

Publish to Confluence

  • View content

  • Create content

  • Edit content

  • Delete anyone's content

  • Delete attachments

The following role permissions are required in both the source and target space.

View activity

View content

Compare versions

View content

Overwrite

  • View content

  • Create content

  • Edit content

  • Add attachments

Manage restrictions

  • View content

  • Create content

  • Manage access to individual content

Use Content Manager

  • View content

  • Create content

  • Edit content

You also require access to the pages in that specific page tree. If you are is restricted from viewing or editing a specific page, you will not be able to update properties like labels.

Manage variants

  • View content

  • Create content

  • Edit content

Manage languages and translations

  • View content

  • Create content

  • Manage access to individual content

  • Delete anyone's content

  • Delete attachments

Before adding or updating a translation, ensure you have view and edit access to all pages in the authoring language. If you are updating an existing translation, you will also need these permissions for the translated page tree.

Enable, switch, and disable workflows

  • View content

  • Create content

  • Manage everything in space

Change workflow status

  • View content

  • Create content

  • Edit content

Perform health checks

View content