stylehub.cloud

Roles and what each one may do

On this page

A brand has four built in roles and 13 permissions. A role is a name for a list of permissions. If somebody cannot do something, look up the permission it needs and check their role against it.

WhereDashboard, Team

The four roles

Owner
Full control, including billing and deleting the workspace. There is one owner.
Admin
Runs the workspace day to day: edits and publishes the manual, manages assets, the team and settings.
Editor
Builds the brand manual and manages assets, but does not manage the team or settings.
Viewer
Read only access to the manual and assets.

You can hand out Admin, Editor, Viewer. Owner is not in the dropdown. A brand has one owner, and the only way to make somebody else the owner is to hand the brand over. See Handing a brand over.

The permissions

The role editor shows them under four headings. The sentence on the right is the label on the checkbox.

The brand manual
Reading it, changing it, and putting it in front of the public.
View the brand manual
manual:read
Edit sections and content
manual:write
Publish and unpublish
manual:publish
Files
The asset library, its folders and its trash.
View assets
asset:read
Upload files, and rename, edit, duplicate and refile them
asset:write
Move files to the trash and empty it
asset:delete
Make and change folders and categories, upload a whole folder, and set who may use each one
asset:folders
The team
Who else is in this brand and what they may do.
See team members
team:read
Invite new members
team:invite
Change roles and remove members
team:manage
The workspace
Settings that apply to the whole brand.
Edit workspace settings and domains
org:settings
Manage billing and plan
org:billing
Delete the workspace
org:delete

Which role holds which permission

PermissionOwnerAdminEditorViewer
View the brand manualYesYesYesYes
Edit sections and contentYesYesYesNo
Publish and unpublishYesYesYesNo
View assetsYesYesYesYes
Upload files, and rename, edit, duplicate and refile themYesYesYesNo
Move files to the trash and empty itYesYesYesNo
Make and change folders and categories, upload a whole folder, and set who may use each oneYesYesNoNo
See team membersYesYesYesYes
Invite new membersYesYesNoNo
Change roles and remove membersYesYesNoNo
Edit workspace settings and domainsYesYesNoNo
Manage billing and planYesNoNoNo
Delete the workspaceYesNoNoNo

An owner holds all 13. An admin holds 11. An editor holds 7. A viewer holds 3, all read only.

What only an owner may hold

Two permissions are reserved for the owner. No other role carries them, and they are not offered when you build a role of your own. That leaves 11 permissions a custom role may be built from.

Manage billing and plan
org:billing
Delete the workspace
org:delete
  • Billing follows the account that owns the brand. An admin can open Billing (opens in a new tab) but cannot change the plan, and the page says so.
  • Deleting the brand asks the owner to type the brand's slug first.

Changing somebody's role

  1. Open Team (opens in a new tab). Every member has a dropdown beside their name, with the built in roles under Built in and any role this brand built under Custom.
  2. Pick the new role.
  3. Press Save. There is no confirmation step.

The change takes effect at once. There is nothing for the other person to accept. Anything the new role does not carry is refused from then on, even from a page they already have open. Their work stays: sections they wrote, files they uploaded and comments they left are untouched by a role change.

The change is recorded, with the role before and after, in History.

Two changes the product refuses

The owner
"The owner's role cannot be changed. Hand the brand over instead, from Team." The owner also cannot be removed from the team.
Your own role
Somebody else changes your role, never you.

Who may change roles

Changing a role, removing a member and revoking an invitation all need team:manage. Inviting needs team:invite, which is separate, so a role can bring people in without being able to change what they may do. The Team page itself needs team:read, which all four built in roles carry.

Without the permission a page needs, you are sent back to the dashboard. If a page keeps bouncing a teammate, find the permission it needs below and check their role.

View the brand manual
The editor, the preview, export, governance, history and analytics.
View assets
The asset library.
See team members
The team page.
Edit workspace settings and domains
Changing Settings (opens in a new tab) and Domains (opens in a new tab), and making or revoking a token on API (opens in a new tab). Without it these pages open read only, which is why a token can only be made by an admin or the owner.
Manage billing and plan
Changing the plan or opening the card portal on Billing (opens in a new tab).

Roles you build yourself

A brand on Business can build its own roles from the 11 permissions that are not owner only, and give one to a member or to somebody being invited. If you delete a custom role, everybody holding it falls back to Viewer, which can see but not change anything. The confirmation says how many people that affects before it happens. See Custom roles and folder access.

The four built in roles are on every plan

Roles you build yourself are part of Business. See What each plan includes, which also has the limit on how many people a brand may have.

Picking a role

  • Viewer for anybody who only needs to read the manual and take files out of it. A printer, a new starter, a client.
  • Editor for the people writing the manual. They can publish, so if you want a pair of eyes first, use review. An editor can also move files to the trash and empty it, but cannot change folders.
  • Admin for whoever runs the brand day to day. Everything an editor has, plus the team, the folders and the settings of the brand.
  • Something narrower when none of the three fits, such as a photographer who uploads files but does not edit the manual.

Where to go next

Still stuck? Write to hello@stylehub.cloud and say which page you were on.

Roles and what each one may do - Stylehub