Comment on pages and blog posts

Comments are a great way to bring others into the conversation about a page or blog post. They allow you to remark on content, add important information, ask questions, and generally drive collaboration and teamwork.

You can add a comment at the bottom of any page or blog post, or add an inline comment by highlighting specific text on the page.

Add a page or blog post comment

  1. Type your comment in the comment field at the bottom of the page
  2. Optionally, choose Preview to see how your comment will appear
  3. By default, Watch this page is ticked (This means you'll start receiving notifications about the page. Uncheck it if you don't want to watch the page.)
  4. Choose Save (Ctrl+S or ⌘+S)

Other users can reply and/or like your comment, and you or a space administrator can edit your comment(s).

Add an inline comment

  1. Highlight the text you want to comment on
  2. Choose the add comment  button that appears above the highlighted text
  3. Type your comment and choose Save (Ctrl+S or ⌘+S)

Screenshot: Create an inline comment by highlighting text.

View inline comments

Text will appear with a yellow highlight to indicate there is an inline comment; select any highlighted text on the page to display the related comment(s).

Just like page and blog post comments, others can reply to, or like, your inline comments, and you'll be notified when they do.

An easy way to check whether there are any inline comments on a page is to select View inline comments from the page tools, or use the keyboard shortcut "v".

Screenshot: No inline comments on a page.

Resolve inline comments

Hit Resolve to hide the thread of inline comments once the conversation's finished. If you want to view resolved comments, select

More options
 > Resolved comments. To reopen a resolved comment, choose Reopen at the bottom left.

Rich comments

Inline and page comments might look simple, but they support rich text (like boldunderline, and italics), bulleted and numbered lists, links, and @mentions. You can also drop images into any comment, to really illustrate your point.

Link to a comment

You can link directly to a comment on a page. See Links for more information. 

If you don't see a popup when you highlight text, check that Text Select is enabled in your profile settings.

Inline comments in the editor

When you are in the editor, there are limitations to how you can interact with inline comments. The below table summarises the differences in behavior when you are in viewing a page and editing it.

FeatureViewing a pageEditing a page
View inline comments(tick)

(tick)

Add and edit inline comments(tick)(error)
Resolve inline comments(tick)
(tick)
Delete inline comments(tick)(tick)
Reply to inline comments(tick)(error)
Like/unlike inline comments(tick)(error)
Close/hide inline comments(tick)(tick)
Quick nav between inline comments(tick)(tick)
Link to inline comment(tick)(error)

When an inline comment is added, resolved, or deleted on a page, this is reflected in the editor without you having to refresh the page. These changes may take up to a minute to reflect on the page.

Comment permissions

  • Add a comment – You need the 'Add Comments' permission in the space.
  • Edit a comment – You need the 'Add Comments' permission. Space administrators can edit all comments within their space. The date on a comment always indicates the time the comment was last edited.
  • Delete a comment – You need the  'Remove Comments' permission.  Deleted comments cannot be restored. If you don't have the 'Remove Comments' permission, you can delete your own comments, but only if there are no replies to your comment.
  • Disable comments – If you don't want comments in a particular space, remove the 'Add Comments' permission from the 'confluence-users' or 'users' group, anonymous users and all other users and groups. The option to add comments will no longer appear on pages or blog posts in that space.

See Space permissions for more information. There is no permission that controls comments across the entire site.

Members of the Confluence-administrators group can add, edit and delete comments, even if you remove their comment permissions in the Space permissions configuration.

Notes

  • Choose Watch at the top-right of the page to receive an email notification whenever anyone edits or adds a comment to the page.
  • On blog posts only, an 'Author' lozenge will appear on any comments made by the original author of the post.
  • It's not possible to delete all comments on a page simultaneously, or change the order of comments.
  • Inline comments on text that is included on a page using the Include macro or Excerpt include macro won't be visible.  They are only visible on the original page. 
Last modified on Aug 22, 2023

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.