Inline Comments

Inline comments let you attach discussions to specific text within a page. Instead of leaving a general comment at the bottom of a page, you highlight the exact sentence, paragraph, or phrase you want to discuss and add a comment directly there. This keeps feedback precise and contextual.

Adding an inline comment

1. Open a page in the editor.
2. Select the text you want to comment on by clicking and dragging.
3. A floating toolbar appears. Click the comment icon (speech bubble).
4. A comment input box appears anchored to the selected text.
5. Type your comment. The input supports rich text formatting (bold, italic, code, links).
6. Click Comment or press Ctrl+Enter / Cmd+Enter to submit.

The commented text is highlighted with a colored background to indicate that a discussion exists on that passage.

Viewing inline comments

Inline comments are visible in two ways:

View	How to access
Inline highlight	Highlighted text in the page body. Click the highlight to open the comment thread.
Comments panel	Click the Comments icon in the page header to open a side panel listing all inline comments in order.

The comments panel shows each comment with:

• The highlighted text snippet for context
• The comment author and timestamp
• The number of replies
• The resolution status (open or resolved)

Replying to comments

1. Click a highlighted text region or open the comments panel.
2. The existing comment thread expands.
3. Type your reply in the input field at the bottom of the thread.
4. Click Reply or press Ctrl+Enter / Cmd+Enter.

Replies are shown in chronological order within the thread. Each reply shows the author name, avatar, and timestamp.

Resolving comments

When a discussion reaches a conclusion, you can resolve the thread:

1. Open the comment thread.
2. Click the Resolve button at the top of the thread.
3. The highlight color changes to indicate a resolved state.
4. Resolved comments are still visible but visually de-emphasized.

To reopen a resolved comment, click the resolved indicator and select Reopen.

Who can resolve comments

Role	Can resolve
Comment author	Yes
Page creator	Yes
Project admin	Yes
Other project members	No (can reply but not resolve)

Editing and deleting comments

Edit a comment

1. Hover over your own comment.
2. Click the ... menu.
3. Select Edit.
4. Modify the text and click Save.

Edited comments show an "edited" label with the edit timestamp.

Delete a comment

1. Hover over your own comment.
2. Click the ... menu.
3. Select Delete.
4. Confirm the deletion.

WARNING

Deleting a comment removes it permanently. If the comment has replies, those replies remain visible but the original comment is replaced with a "deleted" placeholder.

Notifications

Inline comments trigger notifications to keep all participants informed:

Event	Who is notified
New comment on text you wrote	The page author
Reply to your comment	The original comment author
Reply to a thread you participated in	All thread participants
Comment resolved	All thread participants
@mention in a comment	The mentioned member

Notifications appear in the Notification Center and optionally via email, depending on your Notification Preferences.

Inline comments and page access

Inline comment visibility follows the page access rules:

Page access	Who can see comments	Who can add comments
Public	All project members	All project members
Private	Only the page creator	Only the page creator
Shared with specific members	Shared members and creator	Members with editor access or higher
Published (external)	Not visible to external viewers	Not applicable

Inline comments are never exposed on published pages. External viewers see only the page content.

Rich text in comments

Inline comments support a subset of rich text formatting:

Format	How to
Bold	Ctrl+B / Cmd+B or **text**
Italic	Ctrl+I / Cmd+I or *text*
Inline code	`code` or Ctrl+E / Cmd+E
Link	Ctrl+K / Cmd+K or paste a URL
@Mention	Type @ to mention a member

Images and complex blocks (tables, code blocks) are not supported within inline comments. Use the page body for those.

Keyboard shortcuts for comments

Shortcut	Action
Ctrl+Enter / Cmd+Enter	Submit comment or reply
Esc	Close comment input without submitting

Best practices

• Be specific — highlight only the relevant text, not an entire paragraph. This makes it clear exactly what the comment refers to.
• Use comments for questions and suggestions — for structural changes, edit the page directly instead.
• Resolve completed discussions — resolved comments reduce visual noise for future readers.
• Use @mentions — tag specific people when you need their input. This sends them a direct notification.
• Check the comments panel — when reviewing a page, open the comments panel to see all active discussions in one place.
• Keep comments focused — each comment should address one point. If you have multiple pieces of feedback, create separate comments on the relevant text.

Related pages

• Manage Pages — Page creation and management
• Page Editor — Rich text editing guide
• Comments and Activity — Comments on work items
• Notification Center — View and manage notifications