---
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/5/introduction_to_tiny_comments/"
md_url: "https://www.tiny.cloud/docs/tinymce/5/introduction_to_tiny_comments/index.md"
version: "5"
last_updated: "2024-04-09T09:35:32Z"
tokens: 752
---
Important This page documents TinyMCE 5. For new projects, Tiny recommends using the latest, most up-to-date version. [See TinyMCE 8 documentation](../../latest/).
# 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](#gettingstartedwiththecommentsplugin-selectingamode).

## 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

### 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](#gettingstartedwiththecommentsplugin-selectingamode).

**Example**

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

tinymce.init({
  selector: 'textarea#comments-embedded',
  toolbar: 'bold italic underline | addcomment showcomments',
  menubar: 'file edit view insert format tools tc',
  menu: {
    tc: {
      title: 'Comments',
      items: 'addcomment showcomments deleteallconversations'
    }
  },
  plugins: 'paste code tinycomments',
  tinycomments_mode: 'embedded',
  tinycomments_author: currentAuthor,
  tinycomments_can_resolve: function (req, done, fail) {
    var 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:14px }',
  /* The following setup callback opens the comments sidebar when the editor loads */
  setup: function (editor) {
    editor.on('SkinLoaded', function () {
      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/)