diff --git a/_submodules/insiders b/_submodules/insiders
index d2acbc12e..dbdc15687 160000
--- a/_submodules/insiders
+++ b/_submodules/insiders
@@ -1 +1 @@
-Subproject commit d2acbc12e0fbfcd573844af4018dbd0eae5e194c
+Subproject commit dbdc1568746fa00853f6807713d0de9abeb1a79b
diff --git a/docs/_images/common-icons/workflow-history.png b/docs/_images/common-icons/workflow-history.png
new file mode 100644
index 000000000..a8e7ec9a9
Binary files /dev/null and b/docs/_images/common-icons/workflow-history.png differ
diff --git a/docs/workflows/executions/single-workflow-executions.md b/docs/workflows/executions/single-workflow-executions.md
index e7c54e8c2..dec972501 100644
--- a/docs/workflows/executions/single-workflow-executions.md
+++ b/docs/workflows/executions/single-workflow-executions.md
@@ -10,6 +10,13 @@ The **Executions** list in a workflow shows all executions for that workflow.
!!! note "Deleted workflows"
When you delete a workflow, n8n deletes its execution history as well. This means you can't view executions for deleted workflows.
+!!! note "Execution history and workflow history"
+ Don't confuse the execution list with [Workflow history](/workflows/history/).
+
+ Executions are workflow runs. With the executions list, you can see previous runs of the current version of the workflow. You can copy previous executions into the editor to [Debug and re-run past executions](/workflows/executions/debug/) in your current workflow.
+
+ Workflow history is previous versions of the workflow: for example, a version with a different node, or different parameters set.
+
## View executions for a single workflow
In the workflow, select the **Executions** tab in the top menu. You can preview all executions of that workflow.
diff --git a/docs/workflows/history.md b/docs/workflows/history.md
index 4650d6580..929ef9a52 100644
--- a/docs/workflows/history.md
+++ b/docs/workflows/history.md
@@ -7,10 +7,18 @@ description: View and restore previous versions of your workflow.
# Workflow history
!!! info "Feature availability"
- * Full workflow history available on Enterprise Cloud and Self-hosted.
- * Last five workflow versions available for Cloud Pro users.
+ * Full workflow history is available on Enterprise Cloud and Enterprise Self-hosted.
+ * The last five workflow versions are available for Cloud Pro users.
-Use workflow history to view and restore previous versions of your workflows.
+Use workflow history to view and restore previous versions of your workflows.
+
+## Understand workflow history
+
+n8n creates a new version when you:
+
+ * Save your workflow.
+ * Restore an old version. n8n saves the latest version before restoring.
+ * Pull from a Git repository using [Source control](/source-control-environments/). Note that n8n saves versions to the instance database, not to Git.
!!! note "Workflow history and execution history"
Don't confuse workflow history with the [Workflow-level executions list](/workflows/executions/single-workflow-executions/).
@@ -19,14 +27,20 @@ Use workflow history to view and restore previous versions of your workflows.
Workflow history is previous versions of the workflow: for example, a version with a different node, or different parameters set.
-
-
## View workflow history
+To view a workflow's history:
+
+1. Open the workflow.
+1. Select **Workflow history** . n8n opens a menu showing the saved workflow versions, and a canvas with a preview of the selected version.
+
## Restore or copy previous versions
You can restore a previous workflow version, or make a copy of it:
1. On the version you want to restore or copy, select **Options** .
1. Choose what you want to do:
- * **Restore this version**
+ * **Restore this version**: replace your current workflow with the selected version.
+ * **Clone to new workflow**: create a new workflow based on the selected version.
+ * **Open version in new tab**: open a second tab displaying the selected version. Use this to compare versions.
+ * **Download**: download the version as JSON.
diff --git a/mkdocs.yml b/mkdocs.yml
index 42bef9ef4..820e934d9 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -149,6 +149,7 @@ nav:
- Templates: workflows/templates.md
- Sharing: workflows/sharing.md
- Settings: workflows/settings.md
+ - Workflow history: workflows/history.md
- Workflow ID: workflows/workflow-id.md
- Manage credentials:
- credentials/index.md