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

# Version Control

This article explains how to manage versions in Dify's Chatflow and Workflow.

## Overview

**Version Control Panel** allows you to track changes, publish updates, and restore previous versions of your applications.

## Key Concepts

* **Current Draft**: Your working version where you make changes.

<img src="https://assets-docs.dify.ai/2025/03/38296a597c0ca31b5fb70be2234f2363.png" width="400" className="mx-auto" alt="Current draft" />

* **Published Version**: Any version released to production.

* **Latest Version**: The current production version.

<img src="https://assets-docs.dify.ai/2025/03/e4c06a0817c30cf9e8893487c889cb02.png" width="350" className="mx-auto" alt="Latest version" />

* **Previous Version**: Any older published version.

<img src="https://assets-docs.dify.ai/2025/03/4cd05033b93d84b53496f3d02e88601f.png" width="200" className="mx-auto" alt="Prevous version" />

* **Restore**: Return to any earlier version of your application.

<img src="https://assets-docs.dify.ai/2025/03/607a69b5355886b9ae8d23a08e818e35.jpg" width="200" className="mx-auto" alt="Restore feature" />

## Features

* **View all versions**: Access and review details of all published versions.

* **Find specific versions**: Use filters to find a specific version.

* **Publish new versions**: Release new application versions with custom names and release notes.

* **Edit published versions**: Edit the title and release notes of a published version.

* **Delete previous versions**: Remove outdated versions to keep the list organized.

* **Restore published versions**: Load a published version into drafts for modifications.

## How to View All Versions

To view all versions:

1. Click the history icon to enter the Version Control Panel.

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

2. View versions in chronological order with titles, release notes, publish dates, and publishers.

3. *(Optional)* Click **Load More** to view more historical versions.

![load\_more](https://assets-docs.dify.ai/2025/03/df9aeb06128f11089dc2294f0338e2ca.png)

## How to Find a Specific Version

**To find versions you published**:

1. Click the filter icon to open the filter dialog.

2. Choose between:

* **All**: Shows versions published by you and other users
* **Only yours**: Shows only versions you published

<img src="https://assets-docs.dify.ai/2025/03/0bf8fef8858671a8fef160f49dd83dad.jpg" width="200" className="mx-auto" alt="all_or_only_yours" />

**To find named versions**:

Toggle **Only show named versions** to display only the versions with custom names.

<img src="https://assets-docs.dify.ai/2025/03/2473121caa2e25ad1a76ee42a4127fb4.jpg" width="200" className="mx-auto" alt="only_show_named_versions" />

## How to Publish a New Version

To publish a new version:

1. Click **Publish > Publish Update** to release the current version.

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

2. The newly published version will be marked as `Latest` in the panel.

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

## How to Edit a Published Version

To edit a published version:

1. In the Version Control Panel, find the version you want to edit.

2. Click its action menu icon.

3. Choose either:

* **Name this version** for versions with default names.

<img src="https://assets-docs.dify.ai/2025/03/ac149f63da6611d7080d305dd3fad65c.jpg" width="200" className="mx-auto" alt="name_this_version" />

* **Edit version info** for versions with custom names.

<img src="https://assets-docs.dify.ai/2025/03/1d840edf979132a9bbf1e065f95e663c.jpg" width="200" className="mx-auto" alt="edit_version_info_1" />

4. Confirm **Publish**.

![edit\_version\_info\_2](https://assets-docs.dify.ai/2025/03/838e5a12aa277bada6c2a4a214450fa5.jpg)

## How to Delete a Previous Version

To delete a Previous version:

1. Find the published version you want to delete.

2. Click the action menu icon and select **Delete**.

<img src="https://assets-docs.dify.ai/2025/03/25ad1999fc9f6f44fcac04526ac5563a.jpg" width="200" className="mx-auto" alt="delete_version" />

3. Confirm **Delete**.

![delete\_version\_confirm](https://assets-docs.dify.ai/2025/03/9326fd0463d024aac1907c83a37fe13b.jpg)

<Warning>
  * The **Current Draft** cannot be deleted
  * The **Latest Version** (marked as "Latest") cannot be deleted
</Warning>

## How to Restore a Published Version

To restore a published version:

1. Find the published version you want to restore.

2. Click its action menu icon and select **Restore**.

<img src="https://assets-docs.dify.ai/2025/03/c96b714accc29df8e46e711782a7a6a9.jpg" width="200" className="mx-auto" alt="restore_version" />

3. Confirm **Restore**. The system will load the selected version into your current draft.

![restore\_version\_confirm](https://assets-docs.dify.ai/2025/03/f3a6e13f2e910f5c7917f52fe77bdfca.jpg)

## Version Control Workflow

Here is how versions work through a typical workflow:

> Note: Matching colors indicate identical version content.

### Phase 1: Initial Draft

* System creates a **Draft** (Version A).

![phase 1](https://assets-docs.dify.ai/2025/03/35ece9d5d5d4d8c46a3fb5ceae4d0c15.jpeg)

### Phase 2: First Release

* Version A is published, becoming the **Latest Version**.
* System creates a new **Draft** (Version B).

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

### Phase 3: Second Release

* Version B is published, becoming the **Latest Version**.
* Version A becomes a **Previous Version**.
* System creates a new **Draft** (Version C).

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

### Phase 4: Restore

* Version A is restored to **Draft**, replacing Version C.
* Version B remains the **Latest Version**.

![phase 4](https://assets-docs.dify.ai/2025/03/541f1891416af90dab5b51bfec833249.jpeg)

### Phase 5: Publish a Restored Version

* Restored Version A is published, becoming the **Latest Version**.
* Previous Versions A and B become **Previous Versions**.
* System creates a new **Draft** (Version D).

![phase 5](https://assets-docs.dify.ai/2025/03/3572a4f2edef166c3f14e4ec4e68b297.jpeg)

### Complete Workflow Demo

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

## FAQ

* **What are the different version types?**

| Type              | Description                                | Access                         | Deletion               | Restoration     |
| ----------------- | ------------------------------------------ | ------------------------------ | ---------------------- | --------------- |
| Current Draft     | Current work in progress                   | Requires publishing to go live | Not accessible online  | Not deletable   |
| Latest Version    | Current live version                       | Requires new draft for updates | Live and accessible    | Can be restored |
| Previous Version  | Previous published versions                | Can restore to draft           | Stored in history only | Can be restored |
| Published Version | Includes both latest and previous versions | /                              | /                      | /               |

* **What happens to my current draft when restoring a previous version?**

When restoring a previous version, that version's content becomes your new draft. Your current draft will be lost, so please review changes carefully before proceeding.

* **Which apps support version control?**

Version control is currently available for **Chatflow** and **Workflow** applications only. It is not yet supported for **Chatbot**, **Text Generator**, or **Agents**.

<CardGroup cols="2">
  <Card title="Edit this page" icon="pen-to-square" href="https://github.com/langgenius/dify-docs-mintlify/edit/main/en/guides/management/version-control.mdx">
    Help improve our documentation by contributing directly
  </Card>

  <Card title="Report an issue" icon="github" href="https://github.com/langgenius/dify-docs-mintlify/issues/new?title=Documentation%20Issue%3A%20on-cont&body=%23%23%20Issue%20Description%0A%3C%21--%20Please%20briefly%20describe%20the%20issue%20you%20found%20--%3E%0A%0A%23%23%20Page%20Link%0Ahttps%3A%2F%2Fgithub.com%2Flanggenius%2Fdify-docs-mintlify%2Fblob%2Fmain%2Fen/guides/management%2Fversion-control.mdx%0A%0A%23%23%20Suggested%20Changes%0A%3C%21--%20If%20you%20have%20specific%20suggestions%20for%20changes%2C%20please%20describe%20them%20here%20--%3E%0A%0A%3C%21--%20Thank%20you%20for%20helping%20improve%20our%20documentation%21%20--%3E">
    Found an error or have suggestions? Let us know
  </Card>
</CardGroup>