Controlled documents written in the built-in editor keep every version, and you can compare any two of them to see exactly what changed. From the comparison you can also bring an older version's content back. Documents that hold an uploaded file do not have this, and neither do form templates.
Opening a comparison
On the document's Versions tab, each version row has a Compare dropdown listing the document's other versions, newest first. Pick one and the versions list is replaced by the comparison; the page header reads Comparing versions. The same dropdown is available while you are viewing a single version's content.
Back to versions returns to the versions list. Switching to the Details, Vessels or Audit tab also ends the comparison.
Reading the comparison
Each side has its own version dropdown, so you can switch either side without leaving the view. The options show each version's number and status, and the side holding the version that is currently live is marked Current. Picking the version already shown on the other side swaps the two.
- On a desktop screen the two versions are shown side by side, with the version number repeated above each column. On a smaller screen both are interleaved in a single column.
- Above the text, a counter shows how many changes there are, with left and right arrow buttons (Previous change and Next change) that jump between them. Identical versions show No differences between these versions.
- Long stretches with no changes are folded away as unchanged blocks hidden; click Show to expand one.
Restoring an older version
When one side of the comparison is older than the document's highest version, that side offers Restore this version. Restoring never rewrites history: it creates a new draft containing the older version's content, numbered above every existing version. The Restore v… window works like Add new version — choose Patch, Minor, Major or a custom number — and confirms with Restore. The new draft then opens straight away.
From there it goes through the normal cycle: edit it if needed, Send for review, and it only reaches the yachts once it is approved. Until then the currently published version stays live. In the version history the draft is marked Restored from the version it came from.
Because a document can have only one open version at a time, restoring is not offered while a draft or a version in review already exists — the comparison says Finish or reject the open version before restoring.
Who can do what
Anyone who can open the document can compare versions, including a Management Viewer. Restoring creates a version, so it needs a Management Admin or Management User account.