Sorry, the InVision Help Center does not support Internet Explorer. Please download Microsoft Edge or another modern browser.


Roles and Permissions in DSM

User roles are only available with the DSM Enterprise plan. For a quick visual walkthrough of roles and permissions in DSM, check out our DSM Learn Hub.

Design System Manager (DSM) lets you control user roles for both the organization and each library. DSM has three organization-level roles—each with different permissions for what members can access and do within your DSM organization. DSM also has three library-level roles—each with different permissions for what members of the given DSM library can access and do within that library. Each member of your DSM organization can have differing library-level roles from one DSM library to the next.

There is also a DSM visitor designation for members of the associated InVision Enterprise account who do not need to edit the design system, view invite-only libraries, or access DSM via the Sketch tool. To keep up with the latest changes to your organization’s visual language, DSM visitors can view your open-access libraries on the web without requiring a paid seat through your DSM Enterprise subscription.

The various DSM roles and their respective permissions are described below.

Organization-level roles

Your DSM organization consists of three types of DSM collaborators—admin, editor, and viewer. All DSM collaborators must have a paid seat within the organization’s DSM Enterprise subscription. When an organization-level admin invites members of the associated InVision Enterprise account to join the DSM organization, each member will fill a seat previously purchased through the DSM Enterprise subscription.

Admins can allow other members of the associated InVision Enterprise account to access DSM as visitors (non-collaborators). Due to the limited access to the DSM organization, this free visitor designation is best reserved for people who may need to access your DSM web portal but who do not need to access your various DSM libraries in Sketch.

To allow DSM visitors, a DSM organization admin must enable open access:

  1. In your web browser, enter your Enterprise domain (e.g., your-domain.invisionapp.com), and then sign in to your Enterprise account.
  2. In the top navigation area, click DSM.
  3. On the left side of the DSM web view, click People.
  4. Under the Who can access DSM? heading, click the Anyone at [your Enterprise name] option.

All members of your InVision Enterprise team (DSM collaborators and DSM visitors) can access your DSM web portal; however, only paying DSM collaborators can access invite-only libraries on your DSM web portal as well as any of your DSM libraries via the Sketch tool.

Admin

A DSM organization admin can do the following to manage the organization:

  • Add and remove members from the DSM organization
  • Enable open access to let anyone on the InVision Enterprise account access the DSM organization
  • Create new libraries
  • View and edit all libraries in the organization
  • Release new library versions
  • Change member permissions
For Enterprise accounts, only members of the InVision account can be invited as members of the DSM account.

From the DSM web view, an admin can click the People tab to add library members and set their roles.

dsm-enterprise-add-member.gif

In the People section of the DSM web view, an admin can also remove current members or change their roles.

dsm-enterprise-manage-members.png

Editor

A DSM organization editor can do the following to manage the organization:

  • Edit libraries that are available to anyone in the organization
  • Create new libraries
  • Release new library versions

Viewer

A DSM organization viewer has the following permissions:

  • Access your DSM web portal in read-only format (cannot make edits)
  • View the member list on the People tab
  • View organization libraries that have not been set to invite-only (i.e., private libraries)
  • View the design token documentation
  • Download icons
  • Access DSM libraries in Sketch

Visitor

A DSM organization visitor has the following permissions:

  • Access your DSM web portal in read-only format (cannot make edits)
  • View the member list on the People tab
  • View organization libraries that have not been set to invite-only (i.e., private libraries)
  • View the design tokens page
  • Download icons
The visitor role applies to anyone without a paid seat within the organization’s DSM Enterprise subscription. Therefore, you cannot assign someone the visitor role, and visitors cannot access invite-only / private libraries, unless you have password protected the library and shared that password with visitors. To learn more, check out this article: Can I password protect my Design System Manager (DSM) library?

A DSM organization visitor has the following limitations:

  • Cannot access any of your DSM libraries in Sketch
  • Cannot access invite-only DSM libraries in your DSM web portal

Library-level roles

Each admin and editor for your DSM organization can create DSM libraries, making them the admin for the specific libraries they create. They can also invite people to the libraries they create and can assign the invitees’ roles for each specific library.

When inviting other members of your DSM organization to a specific library, the invitees will retain their organization-level permissions. For example, if an organization-level editor creates a library (thereby becoming the library admin) and invites another organization-level editor to that library, that invitee will have editor rights for the library.

The DSM library-level roles and their respective permissions are described below.

Admin

A DSM library admin can do the following to manage the specific library:

  • Manage library sharing settings
  • Invite members of the DSM organization to the library
  • Set roles for library members
  • Edit the library
  • Set up live components and generate authentication tokens (Enterprise only)
    A seat in the DSM organization is not required for a developer to push changes from Storybook to a live component that has already been added to DSM.
  • Release new library versions
Only members of the DSM organization can be invited to a library.

When adding members to a specific DSM library, an admin can also set their library-level roles.

dsm-enterprise-invite-to-library.gif

Editor

A DSM library editor can do the following to manage the specific library:

  • Invite members of the DSM organization to the library
    Invited members will retain their organization-level permissions (e.g., an org-level editor will become a library editor)
  • Edit the library
  • Set up live components and generate authentication tokens (Enterprise only)
    A seat in the DSM organization is not required for a developer to push changes from Storybook to a live component that has already been added to DSM.
  • Release new library versions

Viewer

A DSM library viewer has these permissions for the specific library:

  • View live components, colors, text styles, and other library documentation
  • View design token documentation
  • Download icons
  • Access DSM libraries in Sketch

Visitor

If library permissions are set to Public, or someone has access to the share link and password for a password-protected library, then a DSM visitor can do the following:

  • View library components, colors, and text styles documentation
  • View design token documentation
  • Download icons

Library sharing settings

To access your library's sharing settings from the DSM web view:

  1. Open your desired library.
  2. In the top-right corner, click the Invite button.
    The Invite button is only available when viewing the shared draft. It is not available when viewing other library versions.
  3. To the right of Copy link, click Settings.

Here you can set viewing permissions and add a password.

Library viewing options

Under the Who can view this library? section, there are three viewing options:

  • Anyone in [your DSM organization]: Anyone who is a member of your Enterprise organization can find and view this library.
  • People invited: Only those invited by a member of your DSM organization can find and view this library.
  • Public: Anyone who has the share link can view this library, even if they are outside your organization.
DSM organization admins are also admins of all libraries in the organization, independently of their sharing settings.

Password protected link

Under the Password Protected Link section, you can click the toggle on to enable a password for the library. After toggling on the feature, enter the desired password and click Save. Now anyone accessing the share link will need to enter the password before viewing your library.

password-protect-dsm-library.gif
You cannot require a password for libraries set to Public. For more information, check out this article: Can I password protect my Design System Manager (DSM) library?

Frequently Asked Questions

Have more questions? Check out our DSM Knowledge Base.


Learn something new

Getting Started Guides