Versioning

Versions let you create a snapshot of your design in time so that you can track significant architectural decisions. You can create versions at different levels of hierarchy, from landscapes to domains, systems, and apps. Frozen versions are static. The diagrams and objects can't be edited or removed from your landscape.

You can freeze up to 3 landscapes on the Free plan. Freezing domains, systems, and apps is only available on Growth and Isolation plans.

Freezing a landscape

To freeze a version of your landscape:

1. Click the Latest button on the top left of the navigation beside the org name

2. Click on the Freeze version button

3. Give a version number and add a note to help you track your changes

4. Click on the Freeze landscape button to confirm

You can view the version in the timeline or continue editing the latest version when complete.

If your landscape contains a lot of diagrams and objects, it may take up to 30 seconds to freeze.

Freezing a landsdape

Freezing a domain, system, or app

To freeze a domain, system or app:

1. Click the Latest dropdown on the top left of the screen in a diagram

2. Below the Freeze Landscape button, click on Freeze this domain, Freeze this system, or Freeze this app button

3. Give a version number and a reason to help you track your changes

4. Click on the Freeze button again to confirm

Freezing a system

Viewing the version timeline

The version timeline is a visual way to track changes in your model. You can view a landscape's timeline to see how everything has changed, from domains to systems and apps, over time. This is useful for tracking significant changes in your architecture.

To view a landscape timeline:

1. Click the Latest dropdown beside the landscape at the top left of the screen

2. A timeline of your different versions will appear in the list ordered by most recent

Clicking on the dropdown of each version will show its notes. You can also rename the version, edit the notes, revert to the version, and share a link to the version by clicking on the overflow menu.

Landscape timeline and sharing a version

To view a domain, system, or app timeline:

1. Navigate to a diagram

2. Click on the Latest tab at the top of the screen

3. A list of the current and previous versions will appear

System timeline in a diagram

Sharing a version

Share links & embeds

Version sharing is only available on Growth and Isolation plans.

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.

Sharing a version

Reverting to a previous version

Version reverts are only available on Growth and Isolation plans.

To revert to a specific landscape or domain version:

1. Click on the Latest dropdown in a landscape or diagram

2. Expand the version to view more detail

3. Click on the overflow menu and Revert to this version button

4. Enter a reason for the reversion

5. Click on Revert to this version to confirm

Reverting can't be undone, and you'll lose your latest design. We recommend freezing your latest design before reverting.

Reverting to a landscape version

Versioning with drafts

Drafts & future state design

You can create a maximum of 1 draft per diagram on Free plans. For unlimited drafts, upgrade to Growth or Isolation.

Any drafts created will also be saved in the version. This allows you to see how ideas (as drafts) turn into permanent changes in your architecture in the timeline.