Kontent.ai
Copyright © 2023 Kontent.ai. All rights reserved.
  • Web
  • Privacy policy
  • Cookies policy
  • Consent settings
  • Security
  • GDPR
  • Documentation
  • API reference
  • Product updates
Kontent.ai Learn
  • Plan
  • Set up
  • Model
  • Develop
  • Create

Comments and suggestions

Is this page helpful?
  • Sign in
  • Jan Cerman
    11 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.

    Add comments

    Comments involve specific parts of your content, such as given text or images. 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.
    Your comment will appear as a card to the right of the selected text, highlighted in yellow. To add a comment to an asset, click Add comment on the given asset and then follow steps 3–5 above.
    You can also comment on assets using the Comment button in the top right corner of the asset tile. To comment on the entire content item, start a discussion.

    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 then gets notified by email within a short period of time. To mention a user in a comment, type “@” and choose their name from the list.

    Start discussions

    Discussions are good ways to comment on entire content items, such as to discuss content strategy or plan 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.

    Suggest changes to content

    When reading or reviewing content, editors often need to point out typos or suggest small changes to the text. 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.
    Your suggestion will appear as a card to the right of the selected text, highlighted in purple. You can suggest changes to Text, Rich text, and URL Slug elements.

    Approve content suggestions

    You can click Approve to replace the selected text with the suggested text. This marks the suggestion as approved.

    Resolve comments and suggestions

    Any comment or content suggestion starts a discussion thread where you can add more comments and suggestions. Suggestions are basically special comments and behave similarly. To mark a discussion as resolved, click Resolve at the top right of the discussion thread.

    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.

    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.

    Share links to comments and suggestions

    You can copy links of the open or resolved comments and suggestions that lead to them, which you can then share with your colleagues:
    1. Find the comment in the content item.
    2. Click More actions in the comment.
    3. Select Copy link.
    The same steps also apply to copy links from suggestions, discussions and resolved comments.

    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. 
    Mentioning other users in comments
    Starting discussion over the whole content item.
    Resolving a comment in rich text editor
    Resolved comments and suggestions in a content item
    • Docs
    • Collections
    • Custom elements
    • Environments
    • Keyboard shortcuts
    • Projects
    • Spaces
    • Task management
    • Terminology
    • Web Spotlight
    • Create and delete content items
    • Comments and suggestions
    • Editorial calendar
    • Embed content through components
    • Find and filter
    • Linking
    • Project overview
    • Relations
    • Rich text
    • Tagging
    • Versioning
  • Add comments
  • Start discussions
  • Suggest changes to content
  • Resolve comments and suggestions
  • Find resolved comments
  • Edit comments
  • Hide comments
  • Share links to comments and suggestions
  • Notifications