# Revisions, History and Snapshots

> Track edits with colored revision marks, review tracked changes from Word, compare and restore earlier versions, take snapshots before big changes and see your writing history.

Source: https://writermorph.com/help/revisions-and-snapshots/

WriterMorph gives you three complementary safety nets for your text:

| Tool | What it does | When to use it |
|---|---|---|
| **Revision Mode** | Colors new text (and optionally marks deletions) as you type | Editing passes you want to see at a glance |
| **Version history** | Keeps a version of a card each time you save it | Going back after a change you regret |
| **Snapshots** | Saves a named copy of a document on demand | Before a big rewrite |

There is also **Revert History** for the planner as a whole, and **Writing History** to see how many words you wrote each day.

## Revision Mode

Revision Mode works like the revision colors used in publishing and screenwriting. Each pass gets its own color.

1. Choose **Format › Revision Mode** and pick a level: **First Revision**, **Second Revision**, **Third Revision**, **Fourth Revision** or **Fifth Revision**.
2. Type. New text appears in that level's color.
3. Turn on **Mark Deletions** if you want deleted text to stay visible as struck-through text instead of disappearing.
4. Choose **None** to stop marking.

Use **Format › Revision Mode › Show Revisions** to show all revisions, only one level, or none (hide the colors without removing them).

To go through the changes one by one, select some marked text (or put the cursor in it) and choose:

- **Format › Revision Mode › Accept Revision Marks in Selection**: added text stays and loses its color; text marked as deleted is deleted.
- **Format › Revision Mode › Reject Revision Marks in Selection**: added text is removed; text marked as deleted comes back as normal text.

When you are done:

- **Remove Revision Markings…** lets you choose what to remove.
- **Remove All Revision Marks** clears them all from the document.

> **Tip:** You can change the color of each revision level in **Settings › Editing › Revisions**.

### Tracked changes from Word

When you import a Word (.docx) document with tracked changes into the book, WriterMorph asks once what to do with them:

- **Accept All Changes**
- **Reject All Changes**
- **Keep as Revision Marks**: insertions appear in the First Revision color and deletions are struck through, so you can review them with the Accept and Reject commands above.

Word comments come in as comments, and Word footnotes and endnotes as footnotes. Going the other way, Compile can write your revision marks into a Word file as tracked changes; see [Compile and Export](https://writermorph.com/help/compile-and-export/).

## Version history for cards

Every time you save a card in the card editor, WriterMorph keeps a version.

1. Open the card and go to the editor's **History** (Versions) section.
2. Pick a version to see it.
3. Choose **Compare** to see what changed. Additions and deletions are highlighted, with a count of each.
4. Choose **Restore this version** to bring it back.

To keep the list short, choose **Keep 5** or **Keep 10** to keep only the most recent versions.

## Snapshots

A snapshot is a copy of a document's text at a moment you choose.

- **Documents › Snapshots › Take Snapshot** (⌘5) saves one right away.
- **Take Snapshot with Title…** (⇧⌘5) asks for a name, such as "Before rewrite".
- **Show Snapshots** opens the **Snapshots** tab of the Inspector.

In the Snapshots tab you can:

1. Select a snapshot to read it.
2. Choose **Compare with Current** to see the differences.
3. Choose **Restore** to replace the current text with the snapshot.
4. Rename snapshots so they are easy to find later.

## Revert History

**View › Revert History** opens a panel of automatic revert points for the planner, taken as you save. Pick one and choose **Restore** to roll the planner back. Some operations, such as updating a project from an Obsidian vault, take a revert point first so you can always undo them.

## Writing History

![Writing History: the words you wrote each day, with your writing days, average and best day.](https://writermorph.com/media/h-history.webp)

**Project › Writing History…** shows how many words you wrote, month by month. Click a month to see its days.

- **Draft** counts the words written in the book, **Other** the words written everywhere else in the project, and **Total** both.
- Choose **This Project** or **All Projects** (all projects show only the total), and **All Time**, **This Year** or **Last 30 Days**.
- Below the table you see your writing days, the total, the average per day and your best day.
- **Copy** copies the days as tab-separated text for Numbers or Excel; **Export CSV…** saves them as a file.

## Undo

Of course, **Edit › Undo** (⌘Z) and **Redo** (⇧⌘Z) work everywhere: in text and on the canvas.
