> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polymet.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Release a design system

> Make a version of your design system available to other projects.

Releasing makes the current version of your design system available to the other projects in your organization. Projects linked to it keep the release they have until they choose to update.

## Release a version

1. Open the design system. When it has changes no release includes yet, a card above the generation input says **RELEASE YOUR DESIGN SYSTEM**.
2. Click **Release** on the card. You can also release from the version card in the chat, on the version you are viewing.
3. In **Release new version**, pick a **Version Type**. **Version Preview** shows the current release and the new number.
4. Click **Release**. Linked projects can now update to it.

The release is the version you are viewing. **Release** is disabled while a generation runs (**You can't release while there is a generation in progress**).

## Version types

| Type | Use it for | Example |
| - | - | - |
| **Major** | Breaking changes that aren't backward compatible | v1.2.0 → v2.0.0 |
| **Minor** | New features that are backward compatible | v1.2.0 → v1.3.0 |
| **Patch** | Bug fixes and small improvements | v1.2.0 → v1.2.1 |
| **Custom** | Set your own version number | any number from 0 to 999 in each part |

**Minor** is picked by default. A first release with **Minor** is v0.1.0.

## Releases come from the default branch

Other projects get releases from the design system's default branch, usually main. On another branch, the release dialog says **Only main can be released** (with your default branch's name) and offers **Switch to main**, also named after your default branch. Merge your branch first, then release. See [Branches](https://docs.polymet.ai/team/branches.md).

## After a release

* **Project settings** > **Design System** in the design system shows **Current version**, **Last updated** and **Total versions**.
* Versions from before the latest release can no longer be rolled back to or released. Hovering **Rollback** on one says **Cannot rollback - a newer version has been released**.
* A released design system cannot be deleted from the projects page. Contact support instead.

## Related

* [Use a design system in a project](https://docs.polymet.ai/design-systems/use.md) — how linked projects update to your release
* [Design systems](https://docs.polymet.ai/design-systems/overview.md) — create one, or turn a project into one
* [Versions and rollback](https://docs.polymet.ai/team/versions.md) — a project's history


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.