Reviewing the version history of a workflow in Shopify Flow
Every workflow in Shopify Flow records a complete version history, storing a log of edits, activations, deactivations, and exports of the workflow. Each version item includes details, such as the name of the user who made the change and the timestamp. Changes that you make to your workflow drafts are logged automatically in the version history, and require no additional steps from you.
You can use a workflow's version history when you need to troubleshoot your workflow and identify which users made specific changes to a workflow. You can also restore a previous version of the workflow from the version history.
Any staff member with access to the Flow app can access the version history of any workflow.
On this page
Considerations for the version history
Before using a workflow's version history, review the following considerations:
- Some historical workflow event data is available only from April 2026 onwards.
- Workflow event data is retained in the workflow's version history for only 1 year.
- If multiple edits are made to a version, then the version history displays only the 7 most recent changes by each user.
Access a workflow's version history
You can access a workflow's version history on the workflow details page. The version history includes the following information:
- The date and time the version was logged.
- Any changes in workflow status, such as the workflow version being Active or a Draft.
- The type of changes made to the version, such as whether the workflow was Edited or Activated. If multiple edits are made to a version, then the version history displays only the 7 most recent changes by each user.
- The name of the user that made the change.
- Any issues with the workflow version, such as missing configuration data.
The version history also marks changes made by Sidekick or by Shopify, such as migrations or automated processes.
Steps:
From your Shopify admin, go to Apps > Flow.
Click the workflow that you want to review the version history for.
Click the Version history tab.
Optional: To review a previous version of the workflow, do the following actions:
- Click the version in the version history to access a read-only display of the workflow.
- Optional: Click Compare to view how that version differs from any other version in the Version history tab. To change which version you're comparing against, click a version name.
Restore a previous version of a workflow
You can use the version history to restore a previous version of a workflow. The restored version opens in the editor as a draft, so that you can make changes and resolve issues before you save it.
When you restore a version of a workflow, it discards your current workflow draft and becomes a new version in the version history. The new version of the workflow includes a note in the Recent history column that specifies that it was restored from a previous workflow version. The workflow version that you use to restore isn't overwritten in the Version history, so that you can restore your workflow from the same version again.
Steps:
From your Shopify admin, go to Apps > Flow.
Click the workflow that you want to restore a previous version of.
Click the Version history tab.
Click the version in the version history that you want to restore. This opens the workflow version in a read-only state.
Optional: Click Compare to view how that version differs from any other version in the Version history tab. To change which version you're comparing against, click a version name.
Click Restore version.
In the Restore version dialog, click Restore.
Optional: Make any changes to the draft of the restored workflow in the workflow editor, such as resolving existing workflow validation issues.
Optional: Activate the restored workflow draft:
- If your workflow is inactive, then click Turn on workflow to activate the restored version.
- If your workflow is active, then click Apply changes > Apply.