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

# Version Control

Track changes and manage versions in Chatflow and Workflow apps.

<Info>
  Only available for Chatflow and Workflow apps right now.
</Info>

## How it works

**Current Draft**: Your working version. This is where you make changes. Not live for users.

<Frame>
  ![Current Draft](https://assets-docs.dify.ai/2025/03/38296a597c0ca31b5fb70be2234f2363.png)
</Frame>

**Latest Version**: The live version users see.

<Frame>
  ![Latest Version](https://assets-docs.dify.ai/2025/03/e4c06a0817c30cf9e8893487c889cb02.png)
</Frame>

**Previous Versions**: Older published versions.

<Frame>
  ![Previous Versions](https://assets-docs.dify.ai/2025/03/4cd05033b93d84b53496f3d02e88601f.png)
</Frame>

## Publish versions

Click **Publish** → **Publish Update** to make your draft live.

<Frame>
  ![](https://assets-docs.dify.ai/2025/03/26f3f324ab4ecb965708d553ddd78d97.png)
</Frame>

Your draft becomes the new Latest Version, and you get a fresh draft to work in.

<Frame>
  ![](https://assets-docs.dify.ai/2025/03/67e95de17577bc272addad6c33f8ea59.png)
</Frame>

## View versions

Click the history icon to see all versions:

<Frame>
  ![](https://assets-docs.dify.ai/2025/03/eed667bbc9498425342c09039054cf98.png)
</Frame>

Filter by:

* **All versions** or **only yours**
* **Only named versions** (skip auto-generated names)

<Frame>
  ![Only Named Versions (Skip Auto-Generated Names)](https://assets-docs.dify.ai/2025/03/0bf8fef8858671a8fef160f49dd83dad.jpg)
</Frame>

## Manage versions

**Name a version**: Give it a proper name instead of the auto-generated one

<Frame>
  ![Name a Version](https://assets-docs.dify.ai/2025/03/ac149f63da6611d7080d305dd3fad65c.jpg)
</Frame>

**Edit version info**: Change the name and add release notes

<Frame>
  ![Edit Version Info](https://assets-docs.dify.ai/2025/03/1d840edf979132a9bbf1e065f95e663c.jpg)
</Frame>

**Delete old versions**: Clean up versions you don't need

<Frame>
  ![Delete Old Versions](https://assets-docs.dify.ai/2025/03/25ad1999fc9f6f44fcac04526ac5563a.jpg)
</Frame>

<Warning>
  You can't delete the Current Draft or Latest Version.
</Warning>

**Restore a version**: Load an old version back into your draft

<Frame>
  ![Restore a Version](https://assets-docs.dify.ai/2025/03/c96b714accc29df8e46e711782a7a6a9.jpg)
</Frame>

<Warning>
  This replaces your current draft completely. Make sure you don't have unsaved work.
</Warning>

## Example workflow

Here's how versions work through a typical development cycle:

### 1. Start with a draft

<Frame>
  ![How Versions Work Through a Typical Development Cycle](https://assets-docs.dify.ai/2025/03/35ece9d5d5d4d8c46a3fb5ceae4d0c15.jpeg)
</Frame>

### 2. Publish first version

<Frame>
  ![](https://assets-docs.dify.ai/2025/03/3d1f66cdeb08710f01462a6b0f3ed0a8.jpeg)
</Frame>

### 3. Publish second version

<Frame>
  ![](https://assets-docs.dify.ai/2025/03/92ffbf88a3cbeeeeab47c1bd8b4f7198.jpeg)
</Frame>

### 4. Restore old version to draft

<Frame>
  ![](https://assets-docs.dify.ai/2025/03/541f1891416af90dab5b51bfec833249.jpeg)
</Frame>

### 5. Publish the restored version

<Frame>
  ![](https://assets-docs.dify.ai/2025/03/3572a4f2edef166c3f14e4ec4e68b297.jpeg)
</Frame>

Complete demo:

<Frame>
  ![Complete Demo](https://assets-docs.dify.ai/2025/03/dc7c15a4dfafb72ce7fffea294d5b5e5.gif)
</Frame>

## Tips

* Always test in draft before publishing
* Use descriptive version names for important releases
* Restore versions when you need to rollback quickly
* Keep old versions around for reference
