Scroll Roles
Starting with Scroll Versions 4.4.0, which introduces Confluence 8 compatibility, Scroll Roles can no longer be used with the Scroll Viewport integration exposing multiple version to readers. If Scroll roles are configured in these spaces, Scroll Viewport search results will not return versioned pages.
With Scroll Versions 4.5.0, Scroll Roles are hidden per default and need to be activated manually.
In the majority of cases, using Confluence permissions is a more intuitive and recommended approach to granting permissions. If you're already using Scroll Roles, please consider replacing those with Confluence permissions as outlined below.
Scroll Roles
Scroll Roles classify users into three roles, which space admins can assign from Scroll Add-ons > Administration > Scroll Roles. These are especially useful in larger teams, where responsibilities might be distributed across multiple people. Real-life responsibilities can be mapped to these roles.
Permissions in spaces managed with Scroll Versions depend on Confluence permissions set for the space and if specific users and groups are assigned to the Scroll Versions roles.
If Authors and Reviewers are explicitly defined in a space, Doc-Admins have to be explicitly defined as well. Otherwise, Doc-Admins won't be able to see or create versioned pages.
Group and user pickers in Roles configuration or Page Restrictions screens do not consider if a certain group or a user has access to the space. Please review which group and users have access on the Space Permissions screen before adding roles and restricting versions or pages.
Scroll Role | Description | Availability |
---|---|---|
Doc-Admin | Doc-Admins act as authors, reviewers and readers. They can execute health checks, create and edit versions, variants or languages. Note: When publishing or exporting a space for translation, Doc-Admins have access to all pages in a space. | Always |
Reviewer | Reviewers can browse through versions, compare page versions, access Scroll Versions-related page metadata, and review content that has been submitted for review in a workflow. | If Scroll Versions is activated |
Author | Authors can create and edit pages in versions and submit drafts for review in a workflow. If reviewers are not explicitly defined, authors also act as reviewers. | If Scroll Versions is activated |
Reader | A Reader can view unversioned pages or (published) master pages. Readers aren't explicitly defined. Users with Confluence view permissions and without any Scroll Roles assignment are considered to be readers. |
Workflow Permissions
Scroll Versions has a built-in workflows that track the state of each page and provides functionality for approvals.
A user can perform different transitions depending on their role:
From Draft, to Review | From Review, to Draft | From Review, to Complete | From Complete, to Draft | |
---|---|---|---|---|
Doc-Admin | Yes | Yes | Yes | Yes |
Reviewer | No | Yes | Yes | No |
Author | Yes | No | No | Yes |
Replace Scroll Roles using Confluence permissions
After changes to the Confluence search introduced in Confluence 8, we recommend to assign the required permissions in a Scroll Versions-managed space using Confluence permissions. To assign equivalent rights to users or group previously defined in Scroll Roles, please make sure to assign them the following Confluence permissions:
When using Confluence permissions, Authors also act as Reviewers.
View | Add Page | Admin | |
---|---|---|---|
Doc-Admin | |||
Author/Reviewer | |||
Reader | * |
In case you're using Workflows and same-space publishing in a space and thus need to assign designated Reviewers who can only view and approve pages as well as Readers who can only view public content, this setup should not be affected by the recent changes and content of the public view will remain searchable in Scroll Viewport.
Related articles
- Downgrade to a Previous Version of Scroll Versions
- Supported Macros and Features
- Reduce Confluence Index Flush Jobs
- Deactivate Scroll Versions
- Disable Scroll Versions Onboarding Notifications
- Reduce Confluence Index Flush Jobs
- Supported Macros and Features
- Deactivate Scroll Versions
- Downgrade to a Previous Version of Scroll Versions
- Disable Scroll Versions Onboarding Notifications
- Deactivate Scroll Versions
- Downgrade to a Previous Version of Scroll Versions
- Reduce Confluence Index Flush Jobs
- Disable Scroll Versions Onboarding Notifications
- Find All Spaces with Scroll Versions or Scroll Translations Enabled