> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/guides-and-quickstarts/releases-and-environments/project-version-history-and-diffs.md).

# Project version history and diffs

Version History lets you inspect earlier project configurations. Review changes gives you a granular comparison of your current draft before you release it, including workflow nodes, connections, and interface settings.

{% embed url="<https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2FpGbf9aEyo4TyRGs4yj9W%2FStackAI-Autosave-Guide-Final-Alice.mp4?alt=media&token=af91ef39-a185-467e-a1da-aa680f90a26b>" %}

Start at **4:23** for Version History and **5:41** for the Latest changes sidebar. For saved-status checks and concurrent-edit messages, see [Autosave and concurrent editing](https://docs.stackai.com/technical-reference/releases-and-environments/autosave-and-concurrent-editing.md).

## Before you start

Have permission to edit the project and view its history. Nodes are the workflow steps; Edges are the connections between them. Ask the project owner about unfamiliar configuration changes before using a comparison to approve a release.

## Choose a version

Select **Draft** to open **Version History**. The sidebar separates the current working draft from saved versions. Review the version number and identifying details before opening an entry.

![Version History separates the current draft from the original saved version.](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2Fe8xc4rGOM5IlVJ5AHuIq%2Fautosave-version-history.png?alt=media\&token=91243232-7d71-40ab-b9d5-7c0d21bf7cca)

Use an entry's options to preview the version or choose **Add description**. Save a short description to explain what the version represents. This **Save** applies to the description; the working draft uses autosave.

## Preview the saved configuration

Open the saved version and inspect its **Workflow**. Switch to **Interface** to review the interface configuration saved with that version.

Viewing history does not replace the current draft or publish the project. The restore control replaces the full draft, including workflow and interface; review both before restoring.

## Return to the current draft

Choose **Back to current draft** when you finish inspecting the saved version. Your current edits remain available.

## Inspect the differences

Open the **Publish** menu and choose **Review changes**. The **Latest changes** sidebar separates your draft comparison into **Nodes**, **Edges**, and **Interface**.

On **Nodes**, review the workflow steps and settings marked as changed. Removed and added lines show the original and new values. Expand unchanged lines when you need the surrounding configuration, then collapse them to focus on edits.

![Nodes comparison shows the removed original instruction and added welcome instruction.](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2FnuYEmjuM7o1R4HskdgwC%2Fautosave-nodes-diff.png?alt=media\&token=b9627dd4-7a36-408a-964e-f1b05cad1320)

Select **Edges** to inspect connection changes. Check each changed source and destination because wiring determines the execution path. If the connections are unchanged, no changes are listed.

![Edges shows no changes because the demo kept its original connections.](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2FX2DUhjmPgwaHFzmmLa5u%2Fautosave-edges-diff.png?alt=media\&token=1033014a-595b-457f-9c8d-266bdfa7ddaf)

Select **Interface** to review changes to settings such as the name, description, and interface type alongside the workflow changes.

![Interface comparison shows changes to the description, name, and interface type.](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2FfgfDA79W6bbtQcA7jgKj%2Fautosave-interface-diff.png?alt=media\&token=05c7c759-869f-4d9b-99c4-6700bccbccd2)

Close the comparison when you finish. Reviewing changes does not publish the project.

## Choose the next action after inspecting history

Use the comparison to identify a known good configuration and the change that introduced a problem. Previewing an earlier version leaves the current draft and live release unchanged.

Restoring a historical version replaces the full current draft; it is separate from redeploying a previously released version. For a staged project, use the stage-history **Redeploy** procedure in [Deployments and approval requirements](https://docs.stackai.com/guides-and-quickstarts/releases-and-environments/deployments-and-approval-requirements.md) when returning to an eligible previously deployed version. Follow the project's normal publication or approval process to release a corrected draft.

## Important behavior

* Autosave preserves your editable draft. Publishing makes a version live.
* **Nodes** shows changes to workflow steps; **Edges** shows changes to their connections; **Interface** shows changes to interface configuration.
* Previewing a previous version does not restore or publish it.
* Restoring replaces the full draft, including workflow and interface configuration.

## Related resources

[Autosave and concurrent editing](https://docs.stackai.com/technical-reference/releases-and-environments/autosave-and-concurrent-editing.md)

[Saved Changes, Versions, and Published Releases](https://docs.stackai.com/technical-reference/releases-and-environments/saved-changes-versions-and-published-releases.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/guides-and-quickstarts/releases-and-environments/project-version-history-and-diffs.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
