Comments and suggestions

Jan Cerman
12 minutes
Comments & suggestions
Creating content is usually a collaborative process requiring many people's input. Kontent.ai makes it easy to discuss your content using comments and discussions and propose changes to specific parts of content with suggestions.
Explore your path to mastery

Add comments

Comments involve specific parts of your content, such as given text or images. To comment on the entire content item, start a discussion. To add a comment to the text: 
  1. Select the portion of the text you want to comment on.
  2. Click Add comment.
  3. Write your comment.
  4. (Optional) Type “@” to mention a user.
  5. Click Send.
Comments appear to the right of the selected text, highlighted in yellow.
If you have the preview toggle switched on, you can only see the comment when you click the yellow-highlighted text. To see all comments, switch off the preview toggle.
To add a comment to an asset, click on the given asset and then follow steps 3–5 above.
Adding comment in the rich text editor

Mention your colleagues

Mentions are a quick way of notifying users on a project without the need to add them as contributors. The mentioned user is then notified by email within a short period of time. To mention a user in a comment, type “@” and choose their name from the list.
Mentioning other users in comments

Start discussions

Discussions are good ways to comment on entire content items, such as discussing content strategy or planning how the content will change. They aren’t tied to any specific content element. To start a discussion:
  1. Click More actions in the upper right of the item.
  2. Select  Show discussion.
  3. Write your ideas.
  4. (Optional) Type “@” to mention a user.
  5. Click Comment.
Starting a discussion over the whole content item.

Suggest changes to the content

When reading or reviewing content, editors often need to point out typos or suggest small changes to the text. You can suggest changes to content in the text, rich text, and URL slug elements. To suggest content changes:
  1. Select the portion of the text you want to change.
  2. Click Add suggestion.
  3. Make changes to the selected text.
  4. Click Suggest changes.
Suggestions appear to the right of the selected text, highlighted in purple.
Suggesting a direct content change in the rich text editor

Approve content suggestions

You can click Approve to replace the selected text with the suggested text. This marks the suggestion as approved.
Approving a suggestion in the rich text editor

Resolve comments and suggestions

Any comment or suggestion starts a discussion thread to which you can add more comments and suggestions. To mark a discussion thread as resolved, click Resolve.
Resolving a comment in the rich text editor

Find resolved comments

If you need to find an old comment, you can check to see which comments have been resolved and who resolved them.
  1. Click More actions in the upper right of the item.
  2. Select  Show resolved.
You can reopen resolved comments and suggestions if needed.
Resolved comments and suggestions in a content item

Edit comments

To edit a comment:
  1. Click  More actions in the comment and select Edit.
  2. Start editing the comment.
  3. Click Save (Ctrl + Enter) to post the changes.

Hide comments

You can hide comments to have more space for authoring content:
  1. Click More actions in the upper right of the item.
  2. Select  Hide comments.
If you need to point your colleagues to a specific comment, discussion, resolved comment, or suggestion, you copy and share a direct link to the thread.
  1. Find the comment in the content item.
  2. Click More actions.
  3. Select Copy link.
Copy a link to a comment

Notifications

Users assigned to the content item will receive email notifications about comments and content suggestions. This applies only to content items in the Production environment. The email delivery can take around 10 to 15 minutes after someone adds the last comment. This is because we want to avoid spamming your inbox with each new comment. Instead, we’ll send all the new comments in a single email. You can select notifications you’d like to receive.