Hyperclay
  1. Hyperclay
  2. Docs
  3. Workspace
  4. Version history

Version history

Browse the latest 50 versions of a document, preview how it looked, and restore any earlier version.

Hyperclay records versions of your documents as they change so you can inspect how a document looked at an earlier point and restore it when needed.

How versions are recorded#

Open a document in your workspace and select the Versions tab to see its history. The table lists each version with two columns: Recorded (when the snapshot was taken) and Recorded by (who caused it to be recorded).

Version history says Recorded by, not “Saved by”, and the difference is real. Some versions capture what the document looked like before an action, and the name on them is whoever caused the version to be taken, not whoever wrote those bytes. A first-save safety backup and a restore backup are both like this.

How attribution works on each row:

  • Display names: The name shown in Recorded by is that person’s current display name, so renaming yourself updates your name throughout the history.
  • Edit links: A version created through an edit share link reads Recorded through an edit link.
  • Missing author: If the author’s account is no longer available, the row shows Author unavailable.
  • Recovered tab edits: A snapshot recovered from a tab that was open when the page changed is labelled Recovered edits (From a tab that was open when the page changed.).

Saves made on your computer through the desktop app do not create a platform version on hyperclay.com. Instead, HTML Clay and Hyperclay Local keep their own local backups on disk.

How many versions are kept#

The Versions tab displays up to 50 versions per document (Showing the latest 50 versions.).

Versions stay with the document for as long as it exists, including when you rename or move it. If you delete a document, its versions stay with it in Trash for 30 days and return if you restore the document. Permanently deleting an item from Trash (or letting it expire after 30 days) permanently deletes all of its versions.

View and restore a version#

Anyone who can view the document in the workspace (owners, team editors, and team viewers) can open the Versions tab and click View on any row to inspect that version without changing the live document.

Account owners and team editors can also roll the document back to an earlier version (team viewers do not see the Restore button):

  1. Open the document’s Versions tab.
  2. Click Restore on the version you want to bring back.
  3. In the Restore version of <name> dialog, click Restore version.

Before replacing the current document with the chosen version, Hyperclay saves a backup of the current document first (The current document will be replaced with this saved version. A backup of the current document is saved first.). If you want to undo the restore, you can restore that backup from the top of the Versions list.

If the document was modified after you loaded the history list, restoring stops with This file changed since you last loaded it. Reload and check the latest version before trying again.