Roles

Roles let space owners and admins control access to resources and actions. Storyblok offers two types of roles:

• Default—Admin, Editor, and Owner roles come with predefined permissions that cannot be changed
• Custom roles match the project's content requirements and the organization's editorial team

Custom roles help define which users can perform which tasks. For example, a German translator role in a multilingual project grants users associated with it full access to German content and read-only access to English content.

Other types of users, such as content managers and designers, may have roles that grant them access to specific blocks and assets, respectively.

Tip

A user can have multiple roles in a single space and different roles in other spaces. Contact your space admin for details.

Permissions

Permissions determine which resources and actions a role (and therefore users assigned to it) can access.

Storyblok supports an extensive list of permissions that admins can use to manage access, allowing or denying actions in stories, blocks, fields, assets, languages, datasources, tags, and apps.

Note

To learn more about permission levels, visit the roles developer concept.

Depending on your role, you may be able to view or set permissions. To do this, open Settings → Roles, select the role, then open the relevant tab.

The Blocks permissions tab in the custom roles settings page

Use roles with workflows and releases

Roles are particularly valuable when using features like workflows and releases to streamline content reviews and handle access to sensitive materials.

Workflows

Workflows offer editorial teams a flexible way to manage the content authoring process. For example, add multiple editors to a Reviewer role to assign everyone in this group to a workflow stage.

To do that, open the story and select Workflow from the right-side menu. Select the workflow stage from the dropdown, then choose the role from the Assign to dropdown.

Assign a workflow to a role

Releases

The Releases App helps plan scheduled publication and prevent unauthorized access to confidential content.

To restrict access to a release based on roles, open the Content area and select the relevant release. Choose Restricted and assign the allowed roles from the Select users and roles dropdown.