---
title: "Introduction to Tiny Comments"
description: "Tiny Comments provides the ability to add comments to the content and collaborate with other users for content editing."
canonical_url: "https://www.tiny.cloud/docs/tinymce/latest/introduction-to-tiny-comments/"
md_url: "https://www.tiny.cloud/docs/tinymce/6/introduction-to-tiny-comments/index.md"
version: "6"
last_updated: "2026-06-15T08:51:58Z"
tokens: 968
---
Important This page documents TinyMCE 6. For new projects, Tiny recommends using the latest, most up-to-date version. [See TinyMCE 8 documentation](../../latest/introduction-to-tiny-comments/).
# Introduction to Tiny Comments

## Contents

- For help using comments in TinyMCE, see: [Using comments](../comments-using-comments/).
- For an overview of the TinyMCE Comments plugin, see: [Overview](#overview).
- For information on adding and configuring the comments plugin for TinyMCE, see: [Getting started with the Comments plugin - Selecting a mode](#getting-started-with-the-comments-plugin-selecting-a-mode).

## Overview

> **Note:** This plugin is only available for [paid TinyMCE subscriptions](/pricing/).
The Comments plugin provides the ability to start or join a conversation by adding comments to the content within the TinyMCE editor.

### Collaborate on your projects within your content

The Comments plugin provides:

- A **user interface** to collaborate on content by creating and replying to comments.
- A way to control the delete and resolve operations on a comment or comment thread.

### Primary Comments functions

The Comments plugin allows the user to perform the following functions:

- Create a comment
- Edit a comment
- Reply to a comment
- Lookup a comment
- Resolve a comment thread
- Delete a comment or comment thread

### Supported content

- Text
- Blocks

> **Note:** This feature is only available for TinyMCE 6.1 and later.

  - Tables of contents created using the [Table of Contents](../tableofcontents/) plugin.
  - Images and images with captions created using the [Image](../image/) plugin.
  - Code samples created using the [Code Sample](../codesample/) plugin.
  - Media created using the [Media](../media/) plugin and [Enhanced Media Embed](../introduction-to-mediaembed/) plugin.
  - Embedded pages created using the [Page Embed](../pageembed/) plugin.

### Interactive example

The following example shows how to configure the Comments plugin in **embedded** mode. For information on configuring the Comments plugin, see: [Comments plugin Modes](#getting-started-with-the-comments-plugin-selecting-a-mode).

**Example**

```js
const currentAuthor = 'A Tiny User';
const userAllowedToResolve = 'Admin1';

tinymce.init({
  selector: 'textarea#comments-embedded',
  plugins: 'code tinycomments',
  toolbar: 'bold italic underline | addcomment showcomments',
  menubar: 'file edit view insert format tools tc',
  menu: {
    tc: {
      title: 'Comments',
      items: 'addcomment showcomments deleteallconversations'
    }
  },
  tinycomments_mode: 'embedded',
  tinycomments_author: currentAuthor,
  tinycomments_can_resolve: (req, done, fail) => {
    const allowed = req.comments.length > 0 &&
                  req.comments[0].author === currentAuthor;
    done({
      canResolve: allowed || currentAuthor === userAllowedToResolve
    });
  },
  content_style: 'body { font-family:Helvetica,Arial,sans-serif; font-size:16px }',
  /* The following setup callback opens the comments sidebar when the editor loads */
  setup: (editor) => {
    editor.on('SkinLoaded', () => {
      editor.execCommand('ToggleSidebar', false, 'showcomments', { skip_focus: true });
    });
  }
});
```

## Getting started with the Comments plugin - Selecting a mode

The Comments plugin is available in two *modes*: **Callback mode** and **Embedded mode**.

Callback Mode This is the default mode for the Comments plugin. This mode is used to store the comments outside the content on a server, such as a database. This mode requires a number of callback functions to handle comment data. For instructions on configuring the Comments plugin in callback mode, see: [Configuring the Comments plugin in callback mode](../comments-callback-mode/)

Embedded Mode This mode stores the comments within the content. No callbacks need to be configured for this mode. For instructions on configuring the Comments plugin in embedded mode, see: [Configuring the Comments plugin Comments in embedded mode](../comments-embedded-mode/)

> **Important:** [Comments](#) are only supported when TinyMCE is run in *classic* mode. Comments require the [Sidebar](../customsidebar/), and Sidebars are not supported in *inline* or *distraction free* mode. For more information on the differences between the editing modes, see [Inline editing mode](../use-tinymce-inline/).