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** ![Workflow history icon](/_images/common-icons/workflow-history.png). 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** ![Options icon](/_images/common-icons/three-dot-options-menu.png). 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