Document Revision History & Rollback

When Revision History (tool-revisions) is enabled, Standalone Qwiki automatically snapshots the previous version of a document before every content replacementβ€”across inline Markdown edits, HTML/Form saves, file replacements, and headless api/publish.php overwrites.

Revision History modal showing saved snapshots, preview, download, and restore controls

How Snapshots Are Keyed & Deduplicated

  • Persistent docId Identity: Every document receives an immutable docId, so its revision history follows the chapter even if you rename the title, change the slug, or drag it into a different category.
  • SHA-256 Deduplication: Before writing a snapshot to data/revisions/{docId}/, Qwiki compares SHA-256 hashes and skips creating redundant snapshots when content hasn't actually changed.
  • Configurable Retention: Set Revision History Retention (Snapshots per Document) (revisionsMaxPerDoc, default 20, range 1–200) in βš™οΈ Settings βž” 🌐 General.

Inspecting, Downloading & Restoring Revisions

  1. Open any document and click πŸ•’ (Revision History) in the document toolbar.
  2. Browse timestamped snapshots showing author, action source, and byte size.
  3. For any snapshot, you can:
    • Preview: View text content directly (or inspect binary metadata for PDFs).
    • Download: Download the raw .bak snapshot file to your workstation.
    • Restore: Perform a lock-verified 1-click rollback. Restoring first snapshots the current live file (so a rollback itself is reversible) and checks soft-lock ownership before writing.
Note

Revision snapshots are cleaned up automatically when a document is permanently purged from the Trash Bin or deleted with permanent=true.