Studio

Compare document versions

The document comparison view in Sanity Studio provides a side-by-side view of different document versions.

Side by side comparison

Use the document comparison view to compare document versions. This includes drafts, published, and release versions. To get started, open a document in Sanity Studio that contains multiple document versions.

  • In the top left right corner of the document view, select the "..." icon.
  • Next, select "Compare versions".
Select the "Compare versions" option from the "..." menu.
Select the "Compare versions" option from the "..." menu.

The document comparison view appears over your studio window. It contains a version selection at the top, and two panels that correspond to each document version on the left and right.

Gotcha

The document comparison panel.
The document comparison panel.

Differences between the fields in the right version are highlighted in yellow. You may recognize this from other history or "diff component" tools. In the screenshot above, the Overview field has a yellow highlight along the right edge indicating changes.

You can adjust the compared versions with the version selector at the top of the window.

The document selector enables you to change the version of each panel.
The document selector enables you to change the version of each panel.

Protip

Advanced Version Control

Experimental feature

Advanced Version Control adds inline diff annotations to fields, allowing editors to see how content has changed between versions while they work on it. This functionality is currently available for string fields, but we are working to add it to other field types.

Screenshot of string field in Sanity Studio show diff annotation from "Fall Collection 2025" to "Autumn Collection 2025"

Switching on Advanced Version Control

To switch this on Advanced Version Control, set the advancedVersionControl.enabled configuration option to true. This feature can be switched on or off for different workspaces.

Was this page helpful?