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
Open the Kit you want to version
In the Navigator, find the version dropdown near the top—it will show "Shared Draft" if no versions exist yet
Click the dropdown and select Create version
Enter a version name (e.g., "v 1.0", "Spring 2024", "Brand Refresh")
Add release notes describing what changed (optional but recommended)
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
