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


Roles and Permissions in DSM

With Design System Manager (DSM), you have varying degrees of control over who can access your organization and library. This guide covers all available roles and permission configurations in DSM. For a quick video walkthrough of roles and permissions in DSM, check out our DSM Learn Hub.

Many of these features are specific to DSM Enterprise and are noted as such.

Organization-level roles

Permissions in DSM are set at the organization level and the library level. At the organization level, there are three DSM user types:

  • Admin
  • Editor
  • Viewer

If you’re using DSM Free, the only available user role is admin. If you’re using DSM Enterprise, you have access to all 3 roles. You can assign anyone with a paid seat in your DSM organization to one of those roles.

Users with a role of admin or higher in your InVision Cloud account automatically become admins in your DSM organization.

In addition to the 3 previously mentioned user roles, there is the possibility for 2 other visitor types to your DSM organization:

  • Organization visitors: These are users on your InVision Enterprise account or Cloud V7 team who do not have a seat in the DSM organization. They can view DSM organizations or libraries that are open to everyone at the organization.
  • Public visitors: These are visitors to your DSM site who have access to a public library URL. These visitors can only see public libraries. They cannot access other parts of your DSM organization.

Organization visitors and public visitors don’t require paid seats in your DSM organization, so using either designation is a great way to share DSM with certain stakeholders. If you’re using DSM Enterprise, you can also send anyone password-protected links to any library.

For a complete list of organization-level roles and permissions, check out the following table.

Action Public visitor Organization visitor Viewer Editor Admin
Access DSM via Sketch     check__1_.png check__1_.png check__1_.png
View public libraries in the DSM web view check__1_.png check__1_.png check__1_.png check__1_.png check__1_.png
View organization member list   check__1_.png check__1_.png check__1_.png check__1_.png
Add and remove organization members         check__1_.png
Change member permissions         check__1_.png
Edit organization access         check__1_.png
View password-protected library links check__1_.png check__1_.png check__1_.png check__1_.png check__1_.png
View libraries available to everyone at the organization   check__1_.png check__1_.png check__1_.png check__1_.png
Receive invites to invite-only libraries     check__1_.png check__1_.png check__1_.png
Create, edit, and delete libraries       check__1_.png check__1_.png
Access all libraries in the organization         check__1_.png

Organization access settings

Only DSM admins can edit organization access settings.

There are two different visibility options for your DSM organization:

  • Anyone at your organization
  • Only people invited

If set to Anyone at your organization, members of your InVision Cloud Enterprise or Cloud V7 team can access the DSM web view without necessarily having been invited to DSM. However, only those with a seat in the DSM organization—a viewer, editor, or admin—can access DSM via Sketch.

If set to Only people invited, then access is restricted to only those occupying seats in the DSM organization.

To set your DSM organization’s visibility:

  1. Sign in to the DSM web view as a DSM admin.
  2. In the left-hand navigation, click People.
  3. Under Who can access DSM?, select Anyone at [your organization] or Only people invited.
set-dsm-org-visibility.gif

Inviting users to your organization

Only DSM admins can invite users to the organization.

To invite users to your DSM organization:

  1. Sign in to the DSM web view as a DSM admin.
  2. In the left-hand navigation, click People.
  3. In the Invite collaborators field, type the email address for the person you want to add.
    If you are on an InVision Cloud Enterprise plan or using Cloud V7, the person must already be a member of your InVision Cloud team.
  4. If you are on the DSM Enterprise plan, select a role for the user (Viewer, Editor, or Admin). If you’re using DSM Free, the role is locked to Admin.
  5. Click Invite.

The user will appear as Pending until they accept the invite.

dsm-add-user-to-org.gif

At any time, you can change a user’s role or remove them from the organization. To learn more, check out this article: Managing users in DSM

Library-level roles

The same user roles that exist at the organization level also exist at the library level:

  • Admin
  • Editor
  • Viewer

Like at the organization level, if you’re using DSM Free, the only available user role is admin. If you’re using DSM Enterprise, you have access to all 3 roles. You can assign anyone with a paid seat in your DSM organization to one of those roles.

Organization users typically retain their permissions at the library level; they cannot be downgraded. Organization admins will remain admins at the library level, and organization editors can't lose editor permissions at the library level.

That said, users can sometimes gain new permissions at the library level. For example, when an organization editor creates a library, they become the admin of that library by default. They can also be made admin or editor on any other library. Likewise, organization viewers can be made admins, editors, or viewers on individual libraries.

As mentioned previously, you can have organization visitors and public visitors to your libraries as well, depending on the established settings.

For a complete list of library-level roles and permissions, check out the following table.

Action Public visitor Organization visitor Viewer Editor Admin
Access DSM libraries via Sketch     check.png check.png check.png
View DSM Data in Inspect*   check.png check.png check.png check.png
View live components, colors, text styles, and other library documentation check.png check.png check.png check.png check.png
Download icons  check.png check.png check.png check.png check.png
View design token documentation  check.png check.png check.png check.png check.png
View password-protected library links  check.png  check.png  check.png check.png  check.png
View public libraries check.png  check.png  check.png   check.png check.png
View libraries available to the DSM organization   check.png check.png check.png check.png
Receive invites to invite-only libraries     check.png check.png check.png
Send library invites       check.png check.png
Edit and delete libraries       check.png check.png
Release new library versions       check.png check.png
Set up live components       check.png check.png
Generate auth tokens       check.png check.png
Set roles for library users         check.png
Add password-protected link         check.png
Manage library share settings         check.png

* While DSM Data in Inspect is available for both DSM Free and DSM Enterprise, it is limited to users on an InVision Cloud Enterprise or Cloud V7 Pro plan.

Library sharing settings

Depending on your plan type, libraries in DSM have a variety of sharing settings:

  • Anyone in [your organization]: Anyone who is a member of your InVision Cloud Enterprise organization or Cloud V7 team can find and view the library.
  • People invited: Only invited DSM Enterprise users can find and view the library.
  • Public: Anyone who has the share link can view this library, even if they are outside your organization.

In addition to these 3 access options, DSM Enterprise users can add a password-protected link to a library. When this is enabled, anyone with the link and the password—including public visitors who aren’t part of your organization—can view the library.

If you are an admin on a library, you can edit the sharing settings at any time.

To change the sharing settings for a DSM library:

  1. Sign in the DSM web view and, in the left-hand navigation, click Libraries.
  2. Open a library and, at the top right, click Invite.
  3. Below the To: field, click Settings.
  4. Under Who can view this library?, choose Anyone in [your organization], People invited, or Public.
    If you’re using DSM free, there is no People invited option.
  5. If you’re using DSM Enterprise, you can add a password-protected link.
  6. Click Save.
dsm-edit-library-access.gif

Inviting users to a library

Any admin, editor, or viewer can invite other DSM organization members to a library.

To add users to a DSM library:

  1. Sign in the DSM web view and, in the left-hand navigation, click Libraries.
  2. Open a library and, at the top right, click Invite.
  3. In the To: field, type the email address for the person you want to add.
    The person must first be a member of the DSM organization.
  4. If you are on the DSM Enterprise plan, select a role for the user (Viewer, Editor, or Admin). If you’re using DSM free, the role is locked to Admin.
  5. Click Invite.
dsm-add-user-to-library.gif

At any time, you can remove a user from your library. To learn more, check out this article: Managing users in DSM


Learn something new

Getting Started Guides