User roles and permissions

Brienne Wong

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	Enterprise and Professional only	The Design System team lead. They manage the zeroheight account and contribute to the documentation.
Organization Manager	Enterprise only	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	Enterprise and Professional only	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 Admin¹	Workspace Manager	Editor	Reviewer
Administration
Can add users?	✅	✅	✅	✅	❌³	❌
Can edit users permissions?	✅	✅	✅²	✅²	❌^³	❌
Can remove users from the organization?	✅	✅	❌	❌	❌³	❌
Can access organization integrations?	✅	✅	❌	❌	✅⁴	❌
Can access styleguide analytics?	✅	✅	✅	✅	✅	❌
Can access user integrations?	✅	✅	✅	✅	✅	✅
Can access Billing?	✅	✅	❌	❌	❌	❌
Styleguides
Can create, edit, duplicate or delete styleguides?	✅	❌	✅	❌	✅	❌
Can add design uploads?	✅	❌	✅	❌	✅	❌
Can comment on styleguides?	✅	❌	✅	❌	✅	✅
Can create releases?	✅	❌	✅	❌	✅	❌
Consumes a seat?	✅⁵	❌	✅⁵	❌	✅⁵	✅⁶
Workspaces
Has the same user permissions across workspaces where they are a member?	✅	✅	❌⁷	✅	❌⁷	✅
Can create or delete workspaces?	✅	✅	❌	❌	❌	❌
Can invite or remove users to/from a workspace?	✅	✅	✅⁸	✅⁸	❌	❌
Can edit user permissions within a workspace?⁹	✅	✅	✅	✅	❌	❌

User Permission Notes

¹ Workspace Admins should be thought of as Editors at the organization level who have been granted additional permissions for a specific workspace.
² 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
³ Editors on the Starter plan are able to invite new users
⁴ Configuring SSO is restricted to Organization Admins and Organization Managers
⁵ Counts towards Editor seats
⁶ Counts towards Reviewer seats
⁷ 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.
⁸ 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
⁹ 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 Professional and Enterprise plans only Organization Admins can be the owner, on the Starter plan any Editor 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?

We have the Organization Admin permissions for Professional and Enterprise plans. Organizations can allocate an editor seat to a organization member to be an Organization admin. Alternatively, the Organization Manager permission (available on the Enterprise plan) can be allocated to a user who only requires administration permissions.

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 ot the number of users with the 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.

Integrate with zeroheight

Help Center

Top article results