Kit Versioning lets you control how changes to a Kit are released to your team. Instead of every change going live immediately, you can work in a staging environment and publish updates when you're ready.
How it works
Kit Versioning works like a publishing platform. You make changes in a draft environment called the Shared Draft. When you're ready to share those changes with your team, you bundle them into a named version and release it.
Think of it like software releases—you develop in draft, then publish version 1.0, then 2.0, and so on. Each version captures a snapshot of your Kit at that moment.
Key concepts
Shared Draft The Shared Draft is your staging environment. All edits happen here first. Before you create any versions, everyone sees the Shared Draft. After you release your first version, the Shared Draft becomes visible only to teammates who can edit the Kit (unless you recommend the draft).
Versions A version is a snapshot of the Shared Draft at a specific point in time. Each version has a name (like "v 1.0" or "Spring 2024") and optional release notes explaining what changed.
Recommended version You can mark one version as "recommended" to signal which version teammates should use. Users on older versions will see a notification that a newer recommended version is available.
Why use Kit Versioning?
Make changes without disruption - Edit your Kit in the Shared Draft without affecting what teammates see
Control your release timing - Publish updates on your schedule, not with every small edit
Communicate changes - Use release notes to explain what's new in each version
Let teammates transition at their pace - Users can switch to new versions when convenient for them
Roll back if needed - Previous versions remain accessible if you need to reference or return to them
What happens when you release your first version?
When you release the very first version of a Kit, teammates without edit privileges are automatically moved from the Shared Draft to that version. Since the Shared Draft and first version are identical at that moment, this transition is seamless—your teammates won't notice any change.
From that point forward:
The Shared Draft is only visible to editors (unless you recommend the draft)
All other teammates see the latest recommended version
You can continue making changes in the Shared Draft without affecting what others see
Anyone with access to the Kit can switch between released versions as needed