Docs/Testing & publishing

Snapshots

A Snapshot is a saved copy of your book at one moment. It holds every Chapter, Glossary Item, and Dynamic Component as they were when it was taken. You take Snapshots on demand as restore points. When you publish, the copy your Readers read from is kept here too, as an Edition.

Where to find them

The Snapshots panel opens from the clock icon on the rail to the left of the editor. It lists every Snapshot for the book, newest first, with a display number, the optional name you gave it, and when it was taken.

What a Snapshot captures

A Snapshot captures the whole book:

  • Every Chapter: paragraphs, Headers, media blocks, Triggers.
  • Every Glossary Item: the wiki body, the Facts, the Tags, the category, and its Item, Character and Creature settings, Combat Settings included.
  • Every Dynamic Component: Decision Templates, Dialogue Templates, Dice Templates, Combat Templates, Trade Screens, Calculations.

A Snapshot covers the book only. It doesn't include your account settings, your payout state, or any Reader's session history.

The four kinds

  • Manual: a Snapshot you took yourself. You can name it, up to 30 characters, to record why you saved it ("before Chapter 4 rewrite", "first draft of the inn scene"). The platform assigns the display number and never reuses it.
  • Auto backup: the Snapshot the platform takes for you when you pick Restore & snapshot current first. It captures the current state before the restore runs, so you can get back to where you were if the restore wasn't what you wanted.
  • Edition: the copy an Edition is made from. Its row reads Edition 1, Edition 2 and so on. Each part's Readers read their part of it. Editing your book afterwards doesn't change it.
  • Before Edition: the book as it was when you started working on an Edition. Its row reads Before Edition 2, for example. Discard this Edition puts the book back to it. It can't be renamed or deleted, and it goes when the Edition is published or discarded.

Status

Capturing the book happens in one step. By the time the row appears in the list, it's done. Each Snapshot carries a status:

  • Ready: the normal state. The Snapshot is fully usable.
  • Failed: rare. The capture failed partway, so you can't restore from the Snapshot, and it's safe to delete.

Snapshot caps

Each book keeps up to 5 manual and auto-backup Snapshots combined. The cap is the same for every writer. If you take one past the cap, the oldest Snapshot is evicted to make room: it stays in the list as history, but it can no longer be restored.

Note
Editions and the Before Edition copy don't count toward the cap and are never deleted to make room. The cap only counts the manual and auto-backup Snapshots you take.

Restoring

Restore on a Snapshot replaces the book's current state with the Snapshot's. The list also offers Restore & snapshot current first, which takes an auto-backup of the current state before the restore runs. Use that one: a plain restore is one-way.

Note
A restore removes anything created since the Snapshot (Chapters, Glossary Items, Dynamic Components) and returns the book to what the Snapshot held. A Reading Simulation session you started on the live book is reset. The next time you open the simulation, it starts fresh against the restored state.
Note
A published book isn't restored from a Snapshot. Readers have its parts, so what is published changes only through an Edition, started from your Published page. While one is open, Discard this Edition puts the book back to how it was when you started.

Snapshots and publishing

Every publish copies the book as it is at that moment. An Edition is made from that copy, and each part's Readers read their part of that copy. It reads the same whatever you edit afterwards.

Editions stay in the Snapshots panel. They can't be renamed or deleted, because Readers are reading from them.

Exporting your book

The Snapshots panel also has an Export book button. It downloads your whole book as a single Markdown file: every Chapter, every Glossary Item, and a short summary of your Dynamic Components. The same export is available from the Settings page under Export my books. You can export a book once a minute.

Note
The export is a manuscript: a copy for reading and safekeeping outside Verhaler. The platform can't restore a book from it. If you want something you can roll back to, take a Snapshot.