---
title: "Compare documents with Tiptap"
description: "Compare Tiptap documents and versions and display the changes in the editor."
canonical_url: "https://tiptap.dev/docs/compare/getting-started/overview"
---

# Compare documents with Tiptap

Compare Tiptap documents and versions and display the changes in the editor.

- **1. Get the add-on**

  Compare is a paid add-on that you can purchase and add to your plan. [Contact our
  team](https://tiptap.dev/contact-sales) to get access.
- **2. Access the private registry**

  The Compare extension is published in Tiptap's private npm registry. Authenticate to Tiptap's
  private npm registry by following the [setup guide](https://tiptap.dev/docs/guides/pro-extensions.md).
- **3. Install the extension**

  Install the `@tiptap-pro/compare` package from the private registry using npm or your preferred
  package manager.

**Tiptap Compare** finds and displays the changes between two documents or two versions of the same document.

> **Interactive demo:** [CompareDocuments](https://embed-pro.tiptap.dev/preview/Extensions/CompareDocuments)

Tiptap Compare is headless: you have full control over how changes are displayed and styled. The comparison itself runs without an editor instance, so you can deploy it client-side or server-side.

## Install

First, [contact our team](https://tiptap.dev/contact-sales) to purchase the Compare add-on and add it to your plan.

After gaining access, configure your package manager by following the [private registry
guide](https://tiptap.dev/docs/guides/pro-extensions.md).

Then, install the package:

```bash
npm install @tiptap-pro/compare
```

Add the `Compare` extension to the editor that displays the changes between the two documents.

```ts
import { Compare } from '@tiptap-pro/compare'

const editor = new Editor({
  extensions: [
    Compare,
    // ...other extensions
  ],
})
```

## Use cases

With Tiptap Compare, you can find the changes between two documents or two versions of the same document.

[Compare documents
More →Compare two documents, find what changed, and review the differences.](https://tiptap.dev/docs/compare/guides/compare-documents.md)

[Compare versions
More →Compare two different versions of a collaborative document.](https://tiptap.dev/docs/compare/guides/compare-versions.md)