Version Control in DSM

Note: For a quick visual walkthrough of version control in DSM, check out the DSM Learn Hub.

Design System Manager (DSM) version control fundamentally improves the way you build and manage your design system. The versioning feature is only available on the DSM Enterprise plan. To learn more, check out our comparison of DSM plans.

Creating a new version

When you’re ready to release a new version of your library to your team, you’ll do that from within the Sketch tool.

In Sketch, click the DSM icon () or use the shortcut Command + L.

At the top left, click the drop-down menu.

Hover over your library name and click Release new version.

Enter the version name and a description.

Click Create Version.

The new version is pushed to all team members, and they can access the updated assets and styles immediately. No manual opt-in or download is required.

When you publish a new version, all signed-in users see a notification at the bottom of the DSM modal.

Clicking See What’s New opens the DSM web view, showing a page with all the changes made in the new version. Clicking Switch changes your view to the new library version.

Note: If someone is viewing your DSM library, but they are not signed in to an InVision account, they will not see this notification.

Switching between versions

To switch library versions:

In Sketch, click the DSM icon () or use the shortcut Command + L.

In the top left, click the drop-down menu.

Hover over your library name and click Switch Version.

Click the version you want to switch to.

The top left of the DSM modal will show the name of the library currently used.

Viewing version history

To see a version history along with their details:

Click the DSM icon () or use the shortcut Command + L.

Click the drop-down menu and hover over your library name.

Click Version history.

The DSM web view will open and you can use the ••• (more) menus to view a specific version or compare it with a previous version.

If you compare with a previous version, you’ll see a list of the assets that were added, removed, and changed. Changed items will automatically be compared side by side. Click the item, and then click Highlight Differences to see specific changes.

If at any time you need to return to the version history while in the DSM web view, navigate to the top right of your library's main page and click the version history icon ().

Reverting to a previous version

At any time, you can revert to a previous version of your library. When you do so, the shared draft updates to reflect your selected version.

Note: Any changes made to the shared draft will be lost. If you've made changes that you don't want to lose, publish your shared draft before reverting to a previous version.

To revert to a previous version:

In Sketch, click the DSM icon () or use the shortcut Command + L.

At the top left of the DSM modal, click the drop-down menu.

Hover over your library name and click View on the web.

In the DSM web view, navigate to the top right and click the version history icon ().

To the right of the desired version, click the ••• (more) icon, and then click Revert to this version.

In the pop-up modal, click Revert.

At the top of the page, a notification will appear that the shared draft has been reverted to a previous version. To view the updated shared draft in the DSM web view, click View shared draft.