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:
Click the
Version(Latest)
dropdown on the top centre-left of the screenClick on the
Freeze landscape
buttonGive a version number and a reason to help you track your changes
Click on the
Freeze landscape
button again 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 domain, system, or app
To freeze a domain, system or app:
Click the
Version(Latest)
dropdown on the top left of the screen in a diagramBelow the Freeze Landscape button, click on
Freeze this domain
,Freeze this system
, orFreeze this app
buttonGive a version number and a reason to help you track your changes
Click on the Freeze button again to confirm
You can view the version in the timeline or continue editing the latest version when complete.
Viewing the version timeline
The version timeline is a visual way to track changes in your model and diagrams. You can view timelines for both your landscape and the diagrams contained in them.
Landscape timeline
You can view a landscape's timeline to see how everything, from domains to systems and apps, has changed. This is useful for tracking significant changes in your architecture.
To view a landscape timeline:
Click the
Version (Latest)
dropdown under your landscape name at the top left-centre navigationClick on
View timeline
A timeline of your different versions will appear at the top of the screen
Hovering over each version will show details like when it was created, by whom, a shared link, and other details. The version name and notes can be edited. To view a specific version, click on the version in the timeline.
Navigating to specific domains will show that domain's specific timeline.
Diagram timeline
You can view your timeline in more detail by navigating inside a diagram. Here, you'll see how specific objects like systems or apps have changed across different versions.
To view a diagram timeline:
Click on the
Version (Latest)
dropdown on the top left of the screen in a diagramClick on
View timeline
A timeline of different versions will appear at the top of the diagram canvas
The blue line on the timeline shows a diagram's existence. If the diagram did not exist at a version, you will go to the first diagram of that version when you click on it.
The timeline will show frozen objects at and above your diagram level. For example, opening a timeline at Level 3 (Component) will show frozen landscapes, domains, systems, and apps.
Sharing a version
Version sharing is only available on Growth and Isolation plans.
You can share a version by going to the one you want to share in the timeline and clicking the Share
button on the top right of the screen.
Reverting to a version
Version reverts are only available on Growth and Isolation plans.
To revert to a specific version:
Click on the
Version (Latest)
dropdown in a landscape or diagramClick on
View timeline
Hover over the specific version and click on the
Revert to this version
buttonEnter a reason for the reversion
Click on
Revert to this version
to confirm. The reverted version will appear in the timeline
Reverting can't be undone, and you will lose your latest design. We recommend freezing your latest design before reverting.
Versioning with drafts
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.
Last updated