Backstage user roles

Backstage users can be members of one or more organizations.

A member of an organization always has a role within that organization. This organization role determines what rights (accesses or actions) they can perform within the organization.

As a member of an organization, the Backstage user will also be a member of one or several workspaces, and/or one or several content hubs.

In each of those workspaces or content hubs, that same Backstage user will also have a determined role within the workspace and/or content hub.

Please see the tables below that explain the different possible organization, workspace, and content hub roles.

More information is available on how to manage roles in an organization or in a workspace.

Organization roles

As a Backstage user, you are part of one or several organizations. Your role can be either Admin, Member, Organizer or Guest of the organization. 

A special role, Entitlement manager, also allows users to allocate seats and advanced modules to your organization's workspaces and to download seat usage reports.

To note, Developer API access (enabled at the organization level) is needed for organization members to access, connect, and configure the integrations modules on an organization’s workspace(s). Organization admins by default have Developer API access enabled for that organization. Organization admins can also enable Developer API access for people who have an “Organizer” role within the organization. More information on managing roles within an orgnanization. Workspace roles are not taken into consideration when it comes to having Developer API access.

Organizational roles within workspaces

The following table summarizes the rights of each organization role, within the organization:

Organization and workspace/content hub roles needed to add a user to a workspace/content hub

Note: When reading this table, please note that where we say “workspace”, the same rules apply to content hubs. Remember that users can be added to a workspace/content hub via the organization settings, or via the workspace/content hub settings.

* This is done by first adding the person to the organization, and then adding them to the workspace.

Organizational roles within content hubs

The following table summarizes the rights of each organizational role, in content hubs

Workspace roles

As a Backstage user, you can be a member of one or several workspaces, each with a different role: Manager, Editor, or Viewer.

The following table summarizes the rights of each role within the workspace:

*(unless they are members of the organization that the workspace belongs to)

Content hub roles

As a Backstage user, you can be a member of one or several content hubs, each with a different role: Manager, Editor, or Viewer.

The following table summarizes the rights of each role within the content hub:

Notes: When the Backstage user, with an admin or organizer role within their organization, creates a new content hub, they are automatically set as a manager in the content hub. As manager they can add other team members to the content hub.