Inline comments

The Inline comments feature in Document360 lets team members add contextual feedback directly on selected text within an article, making the review and refinement process faster and more structured. Instead of discussing changes in separate threads, reviewers can highlight a specific passage and attach a comment to it, keeping feedback tied to the exact content it refers to.

When to use inline comments

Use inline comments when you want to give or collect precise, text-level feedback during the content review cycle. Common scenarios include:

• A subject matter expert needs to flag a specific sentence as inaccurate without editing the article directly.
• A team lead wants to suggest rewording on a particular paragraph before the article is published.
• Multiple reviewers are collaborating on a draft and need to track which sections have been addressed.
• You want to keep a record of resolved feedback even after the article goes live.

Before you begin

• The article must be open in the Advanced WYSIWYG editor. Inline comments are not available in the Markdown or standard WYSIWYG editors.
• To review an article without editing permissions, see Managing reviewer accounts.

How to add inline comments to an article

1. Navigate to the desired article in the Knowledge base portal.

2. Confirm that the article is open in the Advanced WYSIWYG editor.

3. Select the text you want to comment on by clicking and dragging the cursor over it. A bubble menu appears.

4. Click the Comment () icon to open the comment box.

5. Inside the comment box, you can:
   • Enter your comment text.
   • Use the @ symbol to mention another user in your project.
   • Apply basic text formatting such as bold and lists. Comments are visually indicated by a yellow highlight on the selected text.

6. Click Send () or press Ctrl + Enter to post the inline comment.

7. To cancel without saving, click anywhere outside the comment box or press ESC.

Inline comments (both open and resolved) are retained even after an article is published. However, they are only visible when the article is open in Edit mode. Once published, the inline comments icon is disabled in the editor. To view or manage comments, you must open the article in the Knowledge base portal's editor.

How to enable comment notifications

To ensure all contributors are notified when inline comments are added:

1. Navigate to Settings () in the left navigation bar of the Knowledge base portal.

2. In the left navigation pane, go to Knowledge base portal > Notifications.

3. Select the Notification mapping tab and scroll to the bottom to find the All comments notification toggle.

4. Turn on the All comments notification toggle.

All contributors to the article will receive email notifications when inline comments are added after this toggle is turned on.

How to manage comments in an article

Once inline comments exist on an article, you can take the following actions from the comments panel:

• View comment: Click the yellow-highlighted area in the article or the comment icon next to the article settings to open the comment thread.
• Resolve comment: Click the () icon to resolve a comment. Users with a default role can resolve any comment, including those added by others. Admins and Owners can control this permission per role by enabling or disabling the Resolve comments setting in the role configuration.
• Edit or delete comment: Select the More () icon at the top of the comment box to edit or delete your comment. These actions are only available for comments you have added.
• Reply to comment: Use the Write a reply field to respond to another user's comment.
• Reopen comment: To continue a discussion on a resolved comment, select the More () icon and select Reopen.

Filtering comments in the discussion section

In the discussion section, you can filter comments using the following options:

Viewing inline comment activity in the Overview page

You can track inline comment activity without opening individual articles. The Comments card on your Overview page shows recent activity relevant to you, including:

• Comments added to articles you have contributed to.
• Comments where you are directly mentioned using @mention.

Each entry in the Comments card shows the article name and the last modified time. Clicking a comment takes you directly to the relevant article and comment thread. The card refreshes automatically every few minutes.

Best practices

• Use @mentions to assign ownership clearly. When a comment requires a specific person's input, tag them with @mention so they receive a notification and the comment appears in their Mentioned me filter.
• Reopen comments sparingly. Use the Reopen option only when additional discussion is truly needed. For new feedback on the same passage, consider adding a separate comment instead.

FAQ