Revision tags are an Application Lifecycle Management (ALM) feature that workspace administrators can use to regularly capture the latest model state of a model’s development

They contain a model's structural information at a point in time. Whenever at least one structural change is made, you can add a revision tag to your model to save those​ changes. All the saved changes in a revision tag can then be synced to a compatible target model

You must be a workspace administrator to add a revision tag to a model. To avoid making production models incompatible for synchronization, we recommend that you only add revision tags to development models.

Use revision tags when features are ready to test or ready for production use. Add a revision tag to your development model and then synchronize the model with your test or production model.

Work with revision tags explains how to:

  • Create a model from a revision tag.
  • Revert a model back to the last revision tag.
  • Compare revision tags in the same model.

Before you add revision tags 

You can add revision tags manually or automatically to a model: 

  • Revision tags can be added manually from the Revision tags page within a model.
  • Revision tags can be added automatically when the model is copied or imported with unsaved structural changes.

Although revision tags are recorded in a model's change history, they don't contribute toward workspace size. 

When to add revision tags

Add a revision tag to create a point in your development model where you can synchronize its structural information with another model.

For example, you can add a revision tag to:

  • Test or release to production new functionality.
  • Fix functionality that is ready to be tested or released to production.
  • Indicate a new minor or major version of the model.

You can also group sets of related changes into separate revision tags (for example, import lists or create driver modules) to mark important milestones in your development model.

When you add a revision tag, we recommend that you:

  • Add at least one revision tag per day during model building.
  • Add a revision tag after you complete a significant piece of model functionality.

Unsupported tasks with revision tags

With revision tags, you cannot:

  • Selectively manage which structural changes are included or excluded in a revision tag.
  • Edit or delete existing revision tags
  • Add revision tags to locked or archived models
  • Add revision tags to deployed models.
  • Revert a model back to the most recent revision tag after a new revision tag has been added.