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

# Compare

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

- **1. Join the pilot program**

  [Contact our team](https://tiptap.dev/contact-sales?form=pilot-program) to join the Compare
  pilot program, available to Business and Enterprise customers.
- **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.

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.

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

## Install

First, [contact our team](https://tiptap.dev/contact-sales?form=pilot-program) to join the Tiptap Compare pilot program.

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)