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.
Current draft

  • Published Version: Any version released to production.

  • Latest Version: The current production version.

Latest version
  • Previous Version: Any older published version.
Prevous version
  • Restore: Return to any earlier version of your application.
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

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

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

load_more

​
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
all_or_only_yours

To find named versions:

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

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

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

latest_version_marked

​
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.
name_this_version
  • Edit version info for versions with custom names.
edit_version_info_1
  1. Confirm Publish.

edit_version_info_2

​
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.

delete_version
  1. Confirm Delete.

delete_version_confirm

  • The Current Draft cannot be deleted
  • The Latest Version (marked as “Latest”) cannot be deleted

​
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.

restore_version
  1. Confirm Restore. The system will load the selected version into your current draft.

restore_version_confirm

​
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

​
Phase 2: First Release

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

phase 2

​
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

​
Phase 4: Restore

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

phase 4

​
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

​
Complete Workflow Demo

workflow

​
FAQ

  • What are the different version types?
TypeDescriptionAccessDeletionRestoration
Current DraftCurrent work in progressRequires publishing to go liveNot accessible onlineNot deletable
Latest VersionCurrent live versionRequires new draft for updatesLive and accessibleCan be restored
Previous VersionPrevious published versionsCan restore to draftStored in history onlyCan be restored
Published VersionIncludes 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.

Edit this page | Report an issue