IcePanel Docs
  • 🧊Welcome
  • 🏁Getting started
  • 💡Core Features
    • Modelling
      • Model objects view
      • Connections list
      • Groups
    • Diagramming
      • Diagrams section
    • Organizations
    • Landscapes
    • Domains
    • Global search
    • Dependencies view
    • Imports
    • Exports
  • 🙌COLLABORATION
    • Comments
    • Share links & embeds
  • Ownership teams
  • Roles & permissions
  • 🖼️Visual Storytelling
    • Flows
      • Flows section
    • Tags
    • Technology choices
  • 🔮Future state design
    • Drafts
    • Versioning
  • 🔁Integrations
    • Linking to reality
    • Code repo linking
      • GitLab
      • GitHub
      • Bitbucket Server
      • Azure DevOps
    • Inaccuracy score
    • REST API
  • 🛠️Experiments
    • MCP server (beta)
  • 🎓Expert help
    • Training
    • Pilot
  • 🎨Templates
    • IcePanel
    • E-commerce
    • Low-code
    • Marketplace
    • RSS feed
    • Bank
  • ❓Other information
    • Glossary
    • SSO - SAML
    • UI theme
    • Hotkeys
    • Troubleshooting
Powered by GitBook
On this page
  • Versioning a landscape or domain
  • Scheduled landscape versions
  • Versioning a system or app
  • Viewing the version timeline
  • Sharing a version
  • Reverting to a previous version
  • Versioning with drafts
  • Automatic scheduling of versions

Was this helpful?

  1. Future state design

Versioning

PreviousDraftsNextLinking to reality

Last updated 4 months ago

Was this helpful?

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. Versions are static, and the diagrams and objects can't be edited or removed from your landscape.

On the free plan, you can create up to 3 landscape versions. Versioning domains, systems, and apps is only available in Growth and Isolation plans.

Versioning a landscape or domain

Only Admins can version a landscape or domain.

To create 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 Create version button.

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

  4. Click on the Create version button to confirm.

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

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

Scheduled landscape versions

Only available on Growth plans and above.

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 on the Scheduledcheckbox.

Versioning a system or app

Only Admins and Editors on a team assigned ownership of the object can version systems or apps.

To version a domain, system or app:

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

  2. Click on the Create versionbutton.

  3. Click on the version dropdown and select system or app.

  4. Give a version number and a reason 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

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.

Reverting to a previous version

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 versioning your latest design before reverting.

Versioning with drafts

Drafts

On free plans, you can create a maximum of 1 draft per diagram. To have 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.

Automatic scheduling of versions

Scheduling versions is only available on growth plan or above

Versions can be automatically scheduled and created on a weekly basis by turning on the scheduled toggle in the version dropdown.

The version will be created every Friday at midnight Pacific Standard Time. For isolated environments this will happen at midnight in the time zone where the environment is located.

🔮
Freezing a landsdape
Scheduling a landscape version
Freezing a system
Landscape timeline and sharing a version
Sharing a version
Reverting to a landscape version
Scheduling a version
Scheduling a version
Page cover image