Search

User roles and permissions

Chi
Chi
  • Updated

You can assign user permissions to users in your organization based the user's needs and the number of Editor/Reviewer seats available on your plan. Below are the user permissions available in zeroheight.

User Permission Plan Availability Example user
Organization Admin Above Starter The Design System team lead. They manage the zeroheight account and contribute to the documentation.
Organization Manager Select plans above Starter A member of the IT team who manages the zeroheight organization but does not require Editor or Reviewer permissions.
Workspaces Admin Enterprise with Workspaces only A Design System team lead at a company with multiple Design System teams. They manage their team's workspace and contribute to the documentation.
Workspaces Manager Enterprise with Workspaces only A member of the IT team who manages a workspace but does not require Editor or Reviewer permissions.
Editor All plans Designers, developers, and copy editors in the Design System team directly contributing documentation.
Reviewer Above Starter Designers, developers, and stakeholders from other teams (e.g. legal) who need to comment on the documentation.

Below is a detailed breakdown of what each user permission enables:

Organization Admin Organization Manager Workspace Admin1 Workspace Manager Editor Reviewer
Administration
Can add users? ✅ ✅ ✅ ✅ ❌3 ❌
Can edit users permissions? ✅ ✅ ✅2 ✅2 ❌3 ❌
Can remove users from the organization? ✅ ✅ ❌ ❌ ❌3 ❌
Can access organization integrations? ✅ ✅ ❌ ❌ ✅4 ❌
Can access styleguide analytics? ✅ ✅ ✅ ✅ ✅ ❌
Can access user integrations? ✅ ✅ ✅ ✅ ✅ ✅
Can access Billing? ✅ ✅ ❌ ❌ ❌ ❌
Styleguides
Can create, edit, duplicate or delete styleguides? ✅ ❌ ✅ ❌ ✅ ❌
Can add design uploads? ✅ ❌ ✅ ❌ ✅ ❌
Can create token sets? ✅ ❌ ✅ ❌ ✅ ❌
Can comment on styleguides? ✅ ❌ ✅ ❌ ✅ ✅
Can create releases? ✅ ❌ ✅ ❌ ✅ ❌
Consumes a seat? ✅5 ❌ ✅5 ❌ ✅5 ✅6
Workspaces
Has the same user permissions across workspaces where they are a member? ✅ ✅ ❌7 ✅ ❌7 ✅
Can create or delete workspaces? ✅ ✅ ❌ ❌ ❌ ❌
Can invite or remove users to/from a workspace? ✅ ✅ ✅8 ✅8 ❌ ❌
Can edit user permissions within a workspace?9 ✅ ✅ ✅ ✅ ❌ ❌

User Permission Notes

1 Workspace Admins should be thought of as Editors at the organization level who have been granted additional permissions for a specific workspace.
2 Workspace Admins and Workspace Managers are only able to make permission changes to existing users that apply to specific workspaces. i.e. giving Editors the Workspace Admin permissions
3 Editors on the Starter plan are able to invite new users
4 Configuring SSO is restricted to Organization Admins and Organization Managers
5 Counts towards Editor seats
6 Counts towards Reviewer seats
7 Most user permissions apply across all workspaces, the only exception is Workspace Admins and Editors. It's possible for a user to be an Editor in one Workspace and a Workspace Admin in another.
8 Workspace Admins and Workspace Managers are able to remove users from workspaces but they can only be removed from the organization by Organization Admins or Organization Managers
9 The only change to existing users' permissions available within a workspace is to change an Editor to a Workspace Admin (and vice versa). Organization Admins and Organization Managers are able to make any role change on the Organization members page.

FAQs

What's an owner?

In the result of a downgrade to the Free plan, the user with the Owner tag is the sole user with access to the organization. On the Starter plan, any Editor can be the Owner, On plans higher than Starter, only Organization Admins can be the owner.

Can we change the organization owner?

Yes, please email support@zeroheight.com

What's a viewer?

Viewers are users who visit your styleguide, they do not need a zeroheight account.

What if I'm unable to change a user's permissions?

If you're experiencing an issue changing a user's permissions, please email support@zeroheight.com and a member of our team will be happy to help you with this.

Does zeroheight support admin permissions?

Yes, plans above Starter have access to an Organization Admin that can manage seats and contribute to documentation. Additionally, select plans above Starter also have access to the Organization Manager role, which can set permissions but does not have editing rights (and will not count toward the seat number). If you're interested in admin permissions and have a Customer Success Manager, reach out to them to see what's available on your account. Otherwise, you can request a demo to learn more about admin permissions and other features available on our higher-tiered plans.

Is there a limit to the number users that can have each set of permissions?

There are no limits to the number of users with the Organization Manager or Workspace Manager permissions.

Limits to the number of users with the Editor, Organization Admin or Workspace Admin permissions are determined by the number of Editor seats on your plan.

Limits on the number of users with Reviewer permissions are determined by the number of Reviewer seats on your plan.

What do viewers see?

To preview what the styleguide looks like for viewers, simply click the Preview button in the top right of your styleguide.

 
three dots menu for styleguide

Was this article helpful?