# Versioning

{% hint style="info" %}
Only Admins can version a landscape or domain.
{% endhint %}

Versions let you create a snapshot of your design at a specific point in time so that you can track significant architectural decisions. You can only create versions at the landscape level. Versions are static, and the diagrams and objects can't be edited or removed from your landscape.

{% embed url="<https://studio.saltfish.ai/demo-share/desktop_1778022401_e6l>" %}

## Manage versions in Icepanel

To see which version you're currently working in, head over to the left sidebar and click on 'Version Current'. The version timeline will show you the version information and let you manage your versions.

![Click 'Version Current' in the left sidebar to see which version you're in and manage your versions.](https://storage.saltfish.ai/demo-recordings/desktop_1778022401_e6l/step_2.jpg)

### Revert Version

{% hint style="warning" %}
Only available on Growth and Scale plans.
{% endhint %}

If you ever need to go back to a previous version, just select 'Revert to version' from this menu. You can also edit the version name and notes by clicking 'Edit version'.

![You can revert to a specific version by selecting the three dots and then 'revert to version'.](https://storage.saltfish.ai/demo-recordings/desktop_1778022401_e6l/step_3.jpg)

Confirm reversions by adding a note and selecting 'Revert Version'.&#x20;

<figure><img src="/files/uthVXQdJufsoCPbk01B8" alt=""><figcaption><p>Confirm reversion of a version</p></figcaption></figure>

### Auto-version

Toggle 'Auto version' on to enable automatic weekly versioning for your landscape on Fridays.

![Toggle 'Auto version' on to enable automatic weekly versioning for your landscape on Fridays.](https://storage.saltfish.ai/demo-recordings/desktop_1778022401_e6l/step_4.jpg)

### Manually Creating a Version

{% hint style="info" %}
On the Free plan, you can create up to 3 versions.&#x20;
{% endhint %}

Click 'Create version' to manually create a new version of your current landscape.

![Click 'Create version' to manually create a new version of your current landscape.](https://storage.saltfish.ai/demo-recordings/desktop_1778022401_e6l/step_6.jpg)

You will need to enter a version name and notes to document the reason for this version.

![Enter a version name and notes to document the reason for this version.](https://storage.saltfish.ai/demo-recordings/desktop_1778022401_e6l/step_9.jpg)

## Sharing a version

[Share links & embeds](/collaboration/sharing.md)

{% hint style="warning" %}
Only available on Growth and Scale plans.
{% endhint %}

You can share a specific version by selecting it from the home page or diagram and clicking the share link option. The version name will be labelled in the share link toggle.

<figure><img src="/files/orE6sCSlughUvWLKDPu3" alt=""><figcaption><p>Sharing a version</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.icepanel.io/future-state-design/versioning.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.