docs: clarify autosaving and versioned flow saving (#12794)

* add-clarification-to-1.9-and-next

* Apply suggestions from code review

Co-authored-by: April I. Murphy <36110273+aimurphy@users.noreply.github.com>

---------

Co-authored-by: April I. Murphy <36110273+aimurphy@users.noreply.github.com>
(cherry picked from commit 7fd8469917)
This commit is contained in:
Mendon Kissling
2026-04-22 11:23:50 -04:00
committed by Eric Hare
parent dbc87e7704
commit aced13ef79
4 changed files with 18 additions and 6 deletions

View File

@ -447,7 +447,7 @@ See [Telemetry](/contributing-telemetry).
| Variable | Format | Default | Description |
|----------|--------|---------|-------------|
| `LANGFLOW_AUTO_SAVING` | Boolean | `True` | Whether to automatically save flows. |
| `LANGFLOW_AUTO_SAVING` | Boolean | `True` | Whether to automatically save the current flow draft. Auto-save only updates the live draft, and doesn't create [saved flow versions](/concepts-flows#save-and-restore-flow-versions). |
| `LANGFLOW_AUTO_SAVING_INTERVAL` | Integer | `1000` | Set the auto-save interval in milliseconds if `LANGFLOW_AUTO_SAVING=True`. |
| `LANGFLOW_BUNDLE_URLS` | List[String] | `[]` | A list of URLs from which to load custom bundles. Supports GitHub URLs. If `LANGFLOW_AUTO_LOGIN=True`, flows from these bundles are loaded into the database. |
| `LANGFLOW_COMPONENTS_PATH` | String | Not set | Path to a directory containing custom components. Typically used if you have local custom components or you are building a Docker image with custom components. |

View File

@ -108,12 +108,18 @@ You can save versions of a flow from the <Icon name="History" aria-hidden="true"
4. Select a previously saved version to preview the flow in read-only mode.
5. To replace the current draft with the selected version, click **Restore**.
When restoring a version, you can keep **Save current draft before restoring** enabled to create a backup of your current work before the selected version replaces it.
From a saved version's <Icon name="EllipsesVertical" aria-hidden="true" /> menu, you can also **Export** or **Delete** that version.
Saved flow versions are stored in the database configured for your Langflow deployment.
When restoring a saved version, if **Save current draft before restoring** is enabled, then Langflow creates a backup of your current work before the selected version replaces it.
[Flow auto-save](/environment-variables#visual-editor-and-playground-behavior) and flow versions serve different purposes.
Auto-save keeps your current flow draft up to date in the background, but it doesn't create version entries.
A saved _version_ is an explicit snapshot that you create when you want a restore point.
When previewing a saved version, Langflow temporarily pauses auto-save so the preview doesn't overwrite your current draft.
### Lock a flow
To prevent changes to a flow, you can lock it:

View File

@ -433,7 +433,7 @@ See [Telemetry](/contributing-telemetry).
| Variable | Format | Default | Description |
|----------|--------|---------|-------------|
| `LANGFLOW_AUTO_SAVING` | Boolean | `True` | Whether to automatically save flows. |
| `LANGFLOW_AUTO_SAVING` | Boolean | `True` | Whether to automatically save the current flow draft. Auto-save only updates the live draft, and doesn't create [saved flow versions](/concepts-flows#save-and-restore-flow-versions). |
| `LANGFLOW_AUTO_SAVING_INTERVAL` | Integer | `1000` | Set the auto-save interval in milliseconds if `LANGFLOW_AUTO_SAVING=True`. |
| `LANGFLOW_BUNDLE_URLS` | List[String] | `[]` | A list of URLs from which to load custom bundles. Supports GitHub URLs. If `LANGFLOW_AUTO_LOGIN=True`, flows from these bundles are loaded into the database. |
| `LANGFLOW_COMPONENTS_PATH` | String | Not set | Path to a directory containing custom components. Typically used if you have local custom components or you are building a Docker image with custom components. |

View File

@ -108,12 +108,18 @@ You can save versions of a flow from the <Icon name="History" aria-hidden="true"
4. Select a previously saved version to preview the flow in read-only mode.
5. To replace the current draft with the selected version, click **Restore**.
When restoring a version, you can keep **Save current draft before restoring** enabled to create a backup of your current work before the selected version replaces it.
From a saved version's <Icon name="EllipsesVertical" aria-hidden="true" /> menu, you can also **Export** or **Delete** that version.
Saved flow versions are stored in the database configured for your Langflow deployment.
When restoring a saved version, if **Save current draft before restoring** is enabled, then Langflow creates a backup of your current work before the selected version replaces it.
[Flow auto-save](/environment-variables#visual-editor-and-playground-behavior) and flow versions serve different purposes.
Auto-save keeps your current flow draft up to date in the background, but it doesn't create version entries.
A saved _version_ is an explicit snapshot that you create when you want a restore point.
When previewing a saved version, Langflow temporarily pauses auto-save so the preview doesn't overwrite your current draft.
### Lock a flow
To prevent changes to a flow, you can lock it: