> For the complete documentation index, see [llms.txt](https://docs.unitlab.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.unitlab.ai/documentation/ontologies/draft-live-and-version-history.md).

# Draft, Live, and version history

Publish ontology changes safely, see who changed what, and restore an earlier version as a new draft.

Every change you make in the builder goes into a **Draft**. Annotators keep using the **Live** version until you publish. Each publish creates a new version, and the history keeps every earlier one.

<figure><img src="https://292810646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGjVLUz4wthGkGlRKM6rM%2Fuploads%2FcWhaH9xeUJj3neDL3UXk%2Fontologies-versions-hero.webp?alt=media" alt="Ontology history with v2 Live, its change events, and v1 below it"><figcaption></figcaption></figure>

## Draft and Live

| State     | What it means                                                                     |
| --------- | --------------------------------------------------------------------------------- |
| **Draft** | Unpublished edits. The header shows **Publish draft**. Annotators don't see them. |
| **Live**  | The version the project labels with. The header shows **Live**.                   |

## Publish a draft

1. Make your changes in the builder.
2. Choose **Publish draft** in the header.

The draft becomes a new version. If it is the project's Live ontology, annotators get the change on the next item they open. If it isn't Live anywhere, Unitlab saves the version and tells you so.

{% hint style="info" %}
Saved labels keep their values when you rename a class or an option. Labels point to the class and option, not to their names.
{% endhint %}

## See what changed

Choose **Version history** in the header. Each version lists its changes, who made them and when. Use **Search history** to find a class or property, and **Filter** to narrow the events.

## Open an older version

Choose **View snapshot** on a version. It opens marked **Snapshot · Read only**, so you can compare classes, properties and JSON without changing anything.

<figure><img src="https://292810646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGjVLUz4wthGkGlRKM6rM%2Fuploads%2FeBp5o29YIXeren8T59hA%2Fontologies-versions-snapshot.webp?alt=media" alt="Read-only snapshot of v1, where Grasp type has three options and no Suction yet" width="600"><figcaption></figcaption></figure>

## Restore an older version

Choose **Restore as draft** on the version. Unitlab copies it into a new Draft. Check it, then choose **Publish draft**. Restoring never deletes the versions in between.

## Switch the project to another ontology

A project can keep several ontologies, such as the current one and a redesign you are testing.

1. Open the project and choose **Ontologies**.
2. Open the row menu of the ontology you want and choose **Make live**.

<figure><img src="https://292810646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGjVLUz4wthGkGlRKM6rM%2Fuploads%2FUv3JYgi0rx41q0arWESx%2Fontologies-make-live.webp?alt=media" alt="Project Ontologies page with the Live ontology and a second one whose row menu shows Make live"><figcaption></figcaption></figure>

The previous ontology is kept and can be made Live again. The Live ontology can't be archived or deleted. Make another one Live first.

## Related

[Test an ontology in Workbench](https://docs.unitlab.ai/documentation/ontologies/test-an-ontology-in-workbench.md) · [Ontologies overview](https://docs.unitlab.ai/documentation/ontologies/ontologies-overview.md) · [Change a live workflow](https://docs.unitlab.ai/documentation/workflows/change-a-live-workflow.md)
