Roles

A role is a defined set of access permissions within a space. A user can have multiple roles in each space and different roles in different spaces.

To assign roles to a user, open Settings > Users and select the relevant user. Then, choose Single role or Multiple roles and select the appropriate roles from the dropdown.

Tip

Why use roles?

Roles set helpful guardrails for access. For example, editors on a news website would typically have broader permissions than content contributors, while reviewers might have read-only access. All these personas can have different roles inside Storyblok.

Each space comes with three default roles:

• Editor: Create and update content
• Admin: Update roles, create content, and update content
• Owner: Create roles, delete roles, update roles, create content, and update content

On top of these default roles, the space owner can also create and manage custom roles with resource-based granular permissions. Custom roles give you more control of your workflow as your team grows. For example, you can have an "English Author" role that only has access to content in English.

To create new roles or manage existing ones, open Settings > Roles. Choose an existing role to manage its permissions or select + Add new role to create a new one and configure the options and permissions.

Add a new role

Permissions

Each role is essentially a collection of permissions. Permissions determine which actions and resources a role (and therefore any users assigned to this role) can access. You can deny/allow access to specific resources and actions within a space.

To view the list of permissions that can be applied to a role, open Settings > Roles.

The permissions section in the roles settings page

The Roles page provides configuration options for denying and allowing specific actions and controlling access to resources, assets, and blocks.

Datasources allowlist

Some permissions (such as datasources) also accept an allowlist: instead of blocking access to resources, you can allow access only to a specific set of resources.

Workflows

Roles also integrate with workflows. For example, if all the content reviewers in your organization have a common role, you could assign a workflow stage to all of them at once.

Assigning a workflow to a role

To do so, select a workflow stage from the Workflow section, and select the role from the Assign to dropdown.