# Versions and revisions

Distinguish versions from revisions and select a version for PDF generation.

You will see both **versions** and **revisions** while working on templates. A version selects the template edition to use; revisions record changes within that edition. Together, they let you develop a design and trace its saved content.

## 1. Versions select what to run

A template can have v1, v2, and subsequent versions. Each has its own content and Draft/Published status. Run lets you select the version before creating a PDF.

For an integration, specify `version` to target the intended edition. If omitted, the system uses the template’s current version, which does not necessarily mean the latest published version.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Run → Version selects the template edition for the job">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>RUN</strong><div class="wf-actions"></div></div><div class="wf-fields"><div><small class="sim-label">VERSION</small><span class="sim-input wf-select sim-focus">v2<svg class="sim-chevron" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><path d="m4 6 4 4 4-4" /></svg></span></div><div><small class="sim-label">VARIANT</small><span class="sim-input wf-select">Standard<svg class="sim-chevron" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><path d="m4 6 4 4 4-4" /></svg></span></div></div></div></div>
<figcaption>Run → Version selects the template edition for the job</figcaption>
</figure>

## 2. Revisions record changes within a version

Saved content is recorded as a revision that you can inspect or restore. For example, v2 may have revision 1 at creation, revision 2 for a content edit, and revision 3 for a CSS change.

A revision number does not replace the version in Run. Selecting v2 does not pin an immutable revision either: v2 can still receive further saves.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="One version contains multiple historical revisions">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>Version 2 · History</strong><div class="wf-actions"></div></div><div class="wf-rows"><div class="sim-focus"><span>Revision 3</span><small>CSS update · current</small></div><div class=""><span>Revision 2</span><small>Content update</small></div><div class=""><span>Revision 1</span><small>Version created</small></div></div></div></div>
<figcaption>One version contains multiple historical revisions</figcaption>
</figure>

## 3. Create a version from an existing one or start blank

Open the version selector in the top bar and choose **New version**. Select a source version and choose **Create** to reuse its design, or choose **Blank** to start empty.

Wait for creation to finish before editing. The new version needs its own review and publication; requests targeting the old number continue to do so until you change them.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="New version → choose a source → Create or Blank">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>New version</strong><div class="wf-actions"></div></div><div class="wf-fields"><div><small class="sim-label">BASED ON</small><span class="sim-input wf-select sim-focus">Version 1<svg class="sim-chevron" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><path d="m4 6 4 4 4-4" /></svg></span></div></div><div class="sim-form-footer ds-pad"><span class="sim-control">Blank</span><span class="sim-control sim-dark">Create</span></div></div></div>
<figcaption>New version → choose a source → Create or Blank</figcaption>
</figure>

## 4. Distinguish version, variant, and schemaVersion

These names refer to different choices:

| Name | Purpose |
| --- | --- |
| Version | Template edition selected for a PDF job. |
| Variant | Alternative values or visibility within a version. |
| `schemaVersion` | Template data format in its JSON file. |

For alternative labels or colors within a shared structure, see [Variants](/docs/data/variants/). To return to an earlier save, use [revision history](/docs/publishing/history/).

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Version and Variant are separate selections in Run">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>RUN</strong><div class="wf-actions"></div></div><div class="wf-fields"><div><small class="sim-label">VERSION</small><span class="sim-input wf-select sim-focus">v2<svg class="sim-chevron" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><path d="m4 6 4 4 4-4" /></svg></span></div><div><small class="sim-label">VARIANT</small><span class="sim-input wf-select">Standard<svg class="sim-chevron" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><path d="m4 6 4 4 4-4" /></svg></span></div></div></div></div>
<figcaption>Version and Variant are separate selections in Run</figcaption>
</figure>