Comparing Revisions

Last modified: April 21, 2026

Introduction

You can compare any historical revision of your version-controlled app to your current working state using the Comparison pane. This helps you understand what has changed since a specific commit, see the impact of your recent edits, or review what is affected if you revert to a past revision.

The comparison shows differences between:

Older revision – the historical revision you selected from the History pane
Newer revision – your current working state, including all uncommitted changes

The comparison always includes your current uncommitted changes, so you can use this feature to see how your recent edits differ from any point in your app's history.

You can only compare a selected historical revision to your current working state. It is not possible to compare two arbitrary past revisions to each other.

For more information on the Comparison pane and its detailed overview, refer to Comparison Pane.

Common Scenarios

What Changed Since a Specific Commit?

You can review all changes made since a specific commit. This helps you understand the scope of work done since the selected commit, made by you or other team members.

What Would Reverting to This Revision Undo?

Before reverting to an older revision, you can compare your current changes to a revision you are considering reverting to and review what changes will be lost. This helps you make an informed decision about whether reverting is safe or if it would undo important work.

Will My Recent Changes Affect a Specific Area?

To check if your recent uncommitted changes affected a specific area of your app, do the following:

Open the History dialog and select your most recent commit (HEAD).
Right-click and select Compare to current state.
Look for the documents or elements you are concerned about.

Because the comparison includes uncommitted changes, you can see the full impact of your current working session.

Tips and Tricks

Use Expand all and Collapse all – In Level 3, use these options to quickly show or hide all nested property paths. This is especially useful when comparing complex elements with many properties.
Right-click any cell – In the grids, right-click any cell and select Copy to copy the cell value to your clipboard. This is useful for documenting changes or sharing information with your team.
Press Enter to drill down and Backspace to go back – Use these shortcuts while when navigating the comparison. This is faster than using the mouse to click buttons.
Understand version conversions – When comparing older revisions, remember that model conversions may introduce minor differences in how properties are displayed. These differences do not affect your stored revisions.