Workflow Version History

Tyler Coleman-Latto
Tyler Coleman-Latto
  • Updated

Overview

Workflow Version History shows you every saved version of a workflow, including when it was published and what it looked like at that point in time. This helps you understand how a workflow evolved and restore previous configurations when needed.

In this article, we'll be covering how to view version history, how to review specific versions, and how to restore a previous workflow configuration.

 

Viewing workflow version history

Version History appears alongside Builder View and Execution History in the workflow detail page.

  1. Navigate to Workflows
  2. Select the workflow you want to inspect
  3. Click the Version History tab in the right-hand panel
CleanShot 2026-02-05 at 16.27.41.gif

The version list displays all saved versions starting from version 1, showing the version number, publish date, and source version for each entry.

You need Workflows > Execution > View permissions to access version history.

 

Understanding version information

Each version displays three pieces of information:

  • Version number — Sequential numbering starting from version 1
  • Published — Date and time when the version was created
  • Source — Which version number this version was created from

The source version becomes more useful as you create more versions, since it helps you trace exactly where a change originated when diagnosing workflow issues.

 

Reviewing a specific version

You can view the exact configuration of any previous workflow version.

  1. Click any version from the Version History list
  2. Review the read-only graph view showing the workflow configuration
  3. Click the JSON icon within the graph to see the JSON representation for that version
  4. Click the back arrow or Version History link to return to the version list
JSON Representation.png

The JSON icon now appears inside the graph view instead of the main workflow page, since the JSON representation is tied to the specific version you're viewing.

 

Restoring a previous workflow version

You can restore any previous workflow version by copying its JSON definition and pasting it into the current workflow.

  1. Navigate to the version you want to restore
  2. Click the JSON icon and copy the JSON representation
  3. Return to the Builder View for the current workflow
  4. Paste the JSON into the workflow definition
  5. Click Save

Saving the workflow creates a new version with the restored configuration. The new version will reference the restored version as its source.

Restoring a workflow replaces the current configuration. Review the version carefully before restoring to avoid unexpected changes to active workflows.

Was this article helpful?

Have more questions? Submit a request