---
title: "Version Control"
icon: "layer-group"
---

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.

![](https://assets-docs.dify.ai/2025/03/38296a597c0ca31b5fb70be2234f2363.png)

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

![](https://assets-docs.dify.ai/2025/03/e4c06a0817c30cf9e8893487c889cb02.png)

**Previous Versions**: Older published versions.

![](https://assets-docs.dify.ai/2025/03/4cd05033b93d84b53496f3d02e88601f.png)

## Publishing versions

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

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

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

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

## Viewing versions

Click the history icon to see all versions:

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

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

![](https://assets-docs.dify.ai/2025/03/0bf8fef8858671a8fef160f49dd83dad.jpg)

## Managing versions

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

![](https://assets-docs.dify.ai/2025/03/ac149f63da6611d7080d305dd3fad65c.jpg)

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

![](https://assets-docs.dify.ai/2025/03/1d840edf979132a9bbf1e065f95e663c.jpg)

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

![](https://assets-docs.dify.ai/2025/03/25ad1999fc9f6f44fcac04526ac5563a.jpg)

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

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

![](https://assets-docs.dify.ai/2025/03/c96b714accc29df8e46e711782a7a6a9.jpg)

<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
![](https://assets-docs.dify.ai/2025/03/35ece9d5d5d4d8c46a3fb5ceae4d0c15.jpeg)

### 2. Publish first version
![](https://assets-docs.dify.ai/2025/03/3d1f66cdeb08710f01462a6b0f3ed0a8.jpeg)

### 3. Publish second version
![](https://assets-docs.dify.ai/2025/03/92ffbf88a3cbeeeeab47c1bd8b4f7198.jpeg)

### 4. Restore old version to draft
![](https://assets-docs.dify.ai/2025/03/541f1891416af90dab5b51bfec833249.jpeg)

### 5. Publish the restored version
![](https://assets-docs.dify.ai/2025/03/3572a4f2edef166c3f14e4ec4e68b297.jpeg)

Complete demo:
![](https://assets-docs.dify.ai/2025/03/dc7c15a4dfafb72ce7fffea294d5b5e5.gif)

## 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