Tiptap Docs

Track changes in your editor

Paid add-onAlpha

The Tracked Changes extension enables suggestion mode for collaborative editing workflows. When enabled, all edits appear as proposals that can be accepted or rejected, similar to change tracking in word processors.

Experimental

This extension is under active development. The API may change in future releases. All versions below 1.0.0 are expected to be unstable, use them at your own risk.

Features

The extension tracks three types of changes:

  • Insertions (add) — New content added to the document
  • Deletions (delete) — Existing content marked for removal
  • Replacements (replace) — Content that was simultaneously deleted and replaced with new content

Each suggestion carries metadata including who created it, when it was created, and a unique identifier.

Key capabilities

  • Suggestion mode — Toggle tracking on and off per user
  • Accept and reject — Review suggestions individually, in bulk, by range, or by user
  • Suggestion grouping — Continuous edits are automatically merged into single suggestions
  • Collaboration ready — Works with Yjs-based real-time collaboration
  • Comments integration — Link suggestions to comment threads for review workflows
  • Atom node support — Tracks changes to images, horizontal rules, and other non-text content
  • Full query API — Find, filter, and inspect suggestions programmatically

Next steps

Next upInstall