> ## Documentation Index
> Fetch the complete documentation index at: https://docs.justflow.it/llms.txt
> Use this file to discover all available pages before exploring further.

# Browse and restore your BPMN diagram version history

> Just Flow It automatically saves version snapshots as you work — browse, preview, and restore any past state of your diagram with a single click.

Every time you make a significant change to a diagram — whether through AI generation, a chat instruction, or a manual edit — Just Flow It automatically saves a version snapshot in the background. You don't need to remember to save; the history builds itself. When you need to revisit an earlier state of a diagram, the version history panel lets you browse every snapshot, preview what it looked like, and restore it instantly.

## Accessing version history

<Steps>
  <Step title="Open a diagram">
    From the **My Diagrams** dashboard, open the diagram whose history you want to browse.
  </Step>

  <Step title="Click the history icon">
    In the editor toolbar, click the **History** icon (a clock with a counter-clockwise arrow). The version history panel slides open on the right side of the screen, replacing the chat panel.
  </Step>

  <Step title="Browse snapshots">
    The panel lists every saved version in reverse chronological order, each labelled with a timestamp and a short description of what changed (for example, "AI generation", "Chat: added approval step", or "Manual edit"). Scroll through the list to find the version you're looking for.
  </Step>

  <Step title="Preview a version">
    Click any version in the list to load a read-only preview of that snapshot in the canvas area. The current diagram is not affected — you're just viewing the past state.
  </Step>

  <Step title="Restore if needed">
    If the previewed version is the one you want to return to, click **Restore this version**. The diagram reverts to that snapshot and a new version entry is added at the top of the history list, recording the restore action.
  </Step>
</Steps>

<Warning>
  Restoring a version **replaces the current state** of your diagram with the selected snapshot. No work is permanently lost — the version you were on before restoring is saved as its own entry in the history list. If you change your mind, open version history again and select that newer entry to get back to where you were.
</Warning>

## What gets saved as a version

Just Flow It creates a new snapshot when you:

* Generate or regenerate a diagram from a prompt
* Apply a chat refinement instruction
* Make and confirm a manual edit (drag, rename, add, or delete elements)
* Run auto-layout on the diagram
* Restore a previous version

Minor interactions — like panning or zooming — do not create new snapshots.

<Note>
  Version history is available on **Pro** and **Team** plans. If you're on the Free plan, the history icon is visible in the toolbar but the panel will prompt you to upgrade to access your snapshots.

  You can upgrade from your account settings.
</Note>

## Tips for working with version history

<CardGroup cols={1}>
  <Card title="Use versions as experiment checkpoints" icon="flask">
    Before making a large structural change — like restructuring swimlanes or asking the AI to rebuild a section — note your current version timestamp. If the result isn't what you wanted, you can jump straight back to that checkpoint from the history panel.
  </Card>

  <Card title="Add context with version names" icon="pen-to-square">
    On Pro and Team plans you can rename any version snapshot by clicking the pencil icon next to its timestamp. Giving key versions meaningful names (like "Approved by stakeholders — 2024-Q2") makes them much easier to find later.
  </Card>

  <Card title="Team plan: see who made each change" icon="users">
    On the Team plan, every version entry shows the avatar and name of the team member who made the change, making it easy to trace the history of collaborative edits.
  </Card>
</CardGroup>

## Frequently asked questions

<Accordion title="How long are version snapshots retained?">
  On the **Pro** plan, snapshots are retained for **90 days**. On the **Team** plan, snapshots are retained for **365 days**. Versions older than the retention window are automatically removed, starting with the oldest.
</Accordion>

<Accordion title="Is there a limit to the number of versions per diagram?">
  There is no hard cap on the number of snapshots per diagram within your retention window. Very active diagrams with hundreds of edits will accumulate many versions, all browsable from the history panel.
</Accordion>

<Accordion title="Can I download or export a specific past version?">
  Yes. While previewing a version, click the **Export** button in the toolbar to download that snapshot as a BPMN 2.0 XML file or PNG image — the same export options available for the current diagram.
</Accordion>