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

# Workflow Version History

> Review published versions and drafts, compare changes side-by-side, and restore earlier definitions into your working copy.

## Overview

The Version History viewer lets you explore every change ever made to a workflow. It lists **published versions** (the definitions that power automated and manual executions) alongside your **current draft**, the auto-saved working copy that has not yet been published. From the viewer you can:

* See when each version and draft was created, and who saved it.
* Switch between versions to inspect their full YAML definitions.
* Compare any two versions (or the draft) using the **Compare** toggles: Previous vs. Selected, Latest vs. Selected, or Draft vs. Selected.
* Restore a previous version into your working copy.
* Publish the draft when you are ready, or discard it if the changes are no longer needed.

## Viewing drafts and versions

1. Open the workflow in **Workflow Builder**.
2. Click **View Version History** in the action bar.
3. The list shows:
   * **Draft**: your auto-saved, unpublished edits. Appears at the top with a "Draft" badge and a relative timestamp so you can confirm when the last auto-save occurred.
   * **Published versions**: ordered chronologically with the most recent at the top. Each entry displays the commit message, author, and timestamp.

Selecting any row opens its metadata panel and preview on the right, so you always know which version the diff viewer is referencing before you compare or restore.

<Tip>
  Drafts remain local to the workflow until you publish. They do not impact scheduled or trigger-based runs.
</Tip>

## Comparing versions with diff

The viewer supports interactive diffs so you can see exactly what changed between any two versions.

<Steps>
  <Step title="Choose versions to compare">
    Use the **Compare** dropdown to pick **Previous vs. Selected**, **Latest vs. Selected**, or **Draft vs. Selected**. The default highlights changes between the selected version and its immediate predecessor so you can step through history quickly.
  </Step>

  <Step title="Review the side-by-side YAML diff">
    The diff viewer uses synchronized scrolling so both panes stay aligned. Added lines appear highlighted in green; removed lines appear in red, making it easy to spot prompt tweaks, parameter changes, or connector updates.
  </Step>
</Steps>

<Note>
  The diff viewer is read-only. To make additional edits, close Version History and continue working in the builder; your changes will update the Draft entry automatically.
</Note>

## Restoring previous versions

If a recently published change introduces issues, or if you simply prefer an older definition, you can restore it into the working copy.

<Steps>
  <Step title="Select the desired version">Click the version in the list to load its details.</Step>

  <Step title="Click Restore to Draft">
    Confirm the action in the modal. The chosen version becomes the new Draft while leaving the original published entry intact for future reference and audit trails.
  </Step>

  <Step title="Review and publish or adjust further">
    After restoration, return to the builder to validate, tweak if necessary, and **Publish** to make it the active version.
  </Step>
</Steps>

<Warning>
  Restoring does not automatically publish the version. Automated executions will **continue using the last published version** until you publish the new draft.
</Warning>

## Best practices

* **Review before you run.** Always verify the draft's diff against the latest published version to confirm expected changes.
* **Publish intentionally.** Provide clear commit messages when publishing so teammates understand why a change was made.
* **Discard stale drafts.** If a draft lingers and is no longer relevant, discard it to avoid confusion.
* **Use restore for quick rollbacks.** Instead of re-editing, restore a known-good version and publish it to roll back fast.

## Related documentation

* [Workflow Versioning](/docs/workflows/workflow-versioning): draft lifecycle, finding unpublished changes, and publish/discard flow
* [Workflow Metadata](/docs/how-to/workflow-builder): configure workflow settings in the builder