Versioning

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 create versions at different levels of hierarchy, from landscapes to domains, systems, and apps. Versions are static, and the diagrams and objects can't be edited or removed from your landscape.

Versioning a landscape or domain

To create a version of your landscape:

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

2. Click on the Create version button.

3. Select the level you want to version. By default, you are versioning the landscape. Select the drop down Version to version any other level. See below for more info on how to version system or app.

4. Enter a version number and add a note to help you track your changes.

5. Click on the Create version button to confirm.

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

Scheduled landscape versions — Auto Version

You can schedule a landscape version to be created automatically once a week (every Friday at 8 pm in your timezone).

• Navigate to the version dropdown on the home page or diagram.

• Click the auto version checkbox

Versioning a system or app

To version a domain, system or app:

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

2. Click on the Create version button.

3. Select the level you want to version. By default, you are versioning the landscape. Select the drop down Version to version any other level. You need to be at the level you are trying to version.

4. Enter a version number and add a note to help you track your changes.

5. Click on the Create version button to confirm.

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 Current 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 the 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 by clicking on the overflow menu.

Sharing a version

Share links & embeds

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.

Reverting to a previous version

To revert to a specific landscape or domain version:

1. Click on the Current 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.

Versioning with drafts

Drafts

Any drafts you create 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.