Browse Document Version History
Every Folio Document keeps a version history automatically. Folio records versions as you work and consolidates them over time, so the history stays short enough to browse.
Opening version history
Open the ⋯ overflow menu in the Utility Bar and choose Version History. From there you can browse the list of versions, compare any two, and restore an earlier one.
How versions are recorded
Each save records a snapshot for the current 5-minute window. If you keep working, further saves inside that same window update that same snapshot rather than creating new ones, and each person who edits during the window is added to the snapshot’s list of editors.
This is why a solid hour of writing doesn’t produce hundreds of versions. It also means a snapshot can carry more than one name — if you and a colleague both edit during the same window, both names appear on it.
How history is consolidated
A nightly job merges older snapshots so the history stays navigable as a Document ages:
| Age | What happens |
|---|---|
| Under 24 hours | 5-minute snapshots are kept as-is |
| Older than 24 hours | 5-minute snapshots merge into hourly snapshots |
| Older than 3 days (72 hours) | Hourly snapshots merge into daily snapshots |
Every merged snapshot keeps that period’s final content and the names of everyone who edited during it. So consolidation costs you intermediate steps, not information about what the Document said or who worked on it.
The practical consequence: recent history is fine-grained and older history is coarse. If you need to recover something from a specific moment, do it in the first day while the 5-minute snapshots still exist. After that you can still get the state at the end of an hour, and later the state at the end of a day.
Version numbering
Version numbers roll up naturally as history consolidates, so the number itself tells you the granularity:
- Daily snapshots —
v1,v2, … - Hourly snapshots —
v1.1,v1.2, … - 5-minute snapshots —
v1.1.1, …
A version numbered v3.2.4 is a 5-minute snapshot from the second hour of the third day of the Document’s history.
Comparing versions
Pick any two versions to compare. The older version appears on the left and the newer one on the right, with the differences highlighted.
Use the Hide unchanged toggle to collapse untouched regions of the Document. On a long document where someone changed one paragraph, this is the difference between reading twelve pages and reading four lines.
Restoring a version
Restoring returns the Document’s content to the state captured in the selected version.
Because restoring is itself a change to the Document, it’s recorded in history like any other edit — so restoring the wrong version isn’t destructive, and you can restore back to where you were.
You need edit access, and the edit lock, to restore a version. If someone else is currently editing the Document, wait for the offer banner before restoring.
How long versions are kept
Versions older than 12 months are removed by default. This retention period is configurable by your Salesforce admin, and it can be set to keep versions forever.
If your team has a compliance or audit reason to retain document history longer than a year, that’s a conversation with your admin — see Version history retention for the setting.
Related: Using the Folio Document Editor · View and Edit at the Same Time · Collaborate with Comments · Browse the Folio Docs home page