Skip to main content

Creating and Releasing Versions

Edward Boatman avatar
Written by Edward Boatman
Updated today

When you're ready to share your Kit changes with your team, you can create a new version. This captures a snapshot of the current Shared Draft and makes it available to everyone.

Admins and Content Managers can create and release Kit versions.

How to create a version

  1. Open the Kit you want to version

  2. In the Navigator, find the version dropdown near the top—it will show "Shared Draft" if no versions exist yet

  3. Click the dropdown and select Create version

  4. Enter a version name (e.g., "v 1.0", "Spring 2024", "Brand Refresh")

  5. Add release notes describing what changed (optional but recommended)

  6. Click Release

After the version is created, you'll be asked if you want to make it the recommended version. Selecting "Yes, recommend" signals to your team that this is the version they should use.

Choosing a version name

Version names help your team understand the state of your Kit. You can use any naming convention that works for you:

  • Semantic versioning: v 1.0, v 1.1, v 2.0

  • Date-based: January 2024, Q1 2024, Spring Release

  • Descriptive: Brand Refresh, Post-Merger Update, New Product Launch

Writing effective release notes

Release notes help teammates understand what changed. Good release notes:

  • Summarize key additions, changes, or removals

  • Highlight anything that might affect how teammates use the Assets

  • Note any Assets that were updated or replaced

Example:

Added new product photography for Summer collection Updated primary logo with refined wordmark Removed deprecated 2022 campaign assets

What happens after you release

Once a version is released:

  • The version becomes available to everyone with access to the Kit

  • Teammates can switch to the new version immediately or when convenient

  • The Shared Draft continues to be your working area for future changes

  • If you made the version "recommended," teammates using older versions will be prompted to switch

Learn more

Did this answer your question?