# Version history

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

Source: https://hyperclay.com/docs/version-history/

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](https://hyperclay.com/docs/share-links/) 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](https://htmlclay.com/docs/guide/backups/) and [Hyperclay Local](https://hyperclaylocal.com/docs/guide/backups/) 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](https://hyperclay.com/docs/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.
