Revision Mode

Revision mode marks what you change as you revise, the way tracked changes do in Word: words you add are coloured, a small mark shows where words were deleted, and a bar in the margin sits beside every changed line. Nothing is locked; you write as usual.

Starting a revision

Choose Start Revision… (Project ▸ Revisions on Mac; on iPad and iPhone, the ⋯ or + menu ▸ Revision). Give the revision a name, such as "Second draft", and choose where to mark changes since: Now, or an earlier checkpoint. A checkpoint records the text as it stands, and from then on your changes are marked.

Start another revision later (Start New Revision… in the same menu) and the words you add from then on take the new revision's colour, while earlier changes keep theirs.

Reviewing changes

Put the caret in a change and a card appears at the foot of the page: what was deleted, struck through, and what replaced it.

• Accept keeps the change and stops marking it.
• Reject puts back what was there before. Undo brings the change back.
• The arrows, or Next Change (⌥⌘]) and Previous Change (⌥⌘[), move from change to change.

The footer shows the current revision and how many changes the open text has. Its menu has the same commands, Show Revision Marks to hide the marks while you read, and, in a shared project, Colour by Author (see Write with Others).

Finishing

Accept All Changes… keeps the text as it is, removes the marks, and ends revision mode. A checkpoint records the moment, so History can still compare before and after.

Reject All Changes… puts every changed document back as it was when the revision began (keeping anything you accepted). A checkpoint is recorded first, so History ▸ Restore can bring back today's text. Documents open in the editor are put back there, so Undo brings your text back too.

Revisions are part of the project, so your other devices show the same marks.