Getting started

Installation

Subscription Required

This extension requires a valid Entry, Business or Enterprise subscription and a running Tiptap Cloud instance. To install the extension you need access to our private registry, set this up first.

Once done, you can install the extension from our private registry:

npm install @tiptap-pro/extension-comments

Integrating the Comments extension

After installing the comments extension via npm or any other package manager, you can use it in your editor by registering the extension in the extensions property of your editor instance.

Since the Comments extension consists of multiple parts including multiple nodes and plugins, you will need to use the CommentsKit extension to add all the required parts to your editor.

import { ThreadsKit } from '@tiptap-pro/extension-comments'

const editor = new Editor({
  ...
  extensions: [
    ...,
    CommentsKit,
  ]
})

This will add all required extensions to your editor. Since Threads are a cloud or on premises feature you will need to also pass through a TiptapCollabProvider instance to your comments extension.

const collabProvider = new TiptapCollabProvider({
  // your provider options
})

const editor = new Editor({
  ...
  extensions: [
    ...,
    CommentsKit.configure({
      provider: collabProvider,
    }),
  ]
})

Your editor is now ready to support threads.