Overview
Workspace members can be assigned roles specific to each design system, allowing their permissions to differ from their general workspace role if needed. This flexible permission management provides enhanced control over member access within your design systems.
With design system roles, you can:
- Manage multiple design system teams with varying permissions in one workspace.
- Grant admin access for a user in one design system, while limiting them to viewer access in another.
- Restrict a member’s access to workspace settings, while giving them higher permissions to manage a design system.
Types of roles in a design system
The following types of roles can be assigned at the design system level:
|
Role |
Seat required? |
Permissions |
|---|---|---|
|
Workspace role (inherit) |
N/A |
The role is automatically inherited from the user's workspace-level role. |
|
Admin |
Yes |
An admin can edit all aspects of the design system and manage members. |
|
Editor |
Yes |
Editors can edit design system content and approve or publish documentation pages, but cannot access settings. |
|
Contributor |
Yes |
Contributors can participate in creation and editing of design system content, but are unable to approve or publish documentation pages, or access settings. |
|
Viewer |
No |
Viewers can see and use design system content, but can’t add or edit existing design system data. |
Manage design system members
Change design system role
To change a member’s role in a design system:
- Hover over the relevant team member and click Change role.
- In the dropdown, select the role you would like to change to.
- The member’s role will now be changed — they will now only be allowed to take actions in the design system that correspond with their design system role.
Inherit workspace role
The role is automatically inherited from the user's workspace-level role. This means that if the workspace role changes, the same role will also be applied in all design systems. This is the default setting, and you can always return to this setting by selecting “Workspace role” in the Change role dropdown.
Remove design system member
Design system members can only be removed when a design system is invite only. See Invite only design systems for more information.
FAQ
The owner and billing roles are used to grant workspace permissions only. These roles convert to admin and viewer in a design system, respectively.
To assign a role higher than viewer in a design system, a member must occupy a paid seat at the workspace level (Contributor or higher).
First change the role in the workspace before changing it in the design system. See Managing your team for more details.