Documentation for Confluence 5.7.
Documentation for Confluence Cloud and earlier versions of Confluence is available too.

Skip to end of metadata
Go to start of metadata

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, or 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 to specific text on the page. 

Page comments are displayed at the bottom of the page, below the page content, and inline comments are displayed to the right of the page adjacent to the highlighted text.

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

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

Add an inline comment

On this page:

Related pages:

  1. Highlight the text you want to comment on
  2. Choose the add commentbutton that appears above the highlighted text
  3. Type your comment and choose Save

The selected text will appear with a yellow highlight indicating an inline comment; choose any highlighted text on the page to display the related comment(s).

Inline comments might look simple, but they support rich text – like boldunderline, and italics – links, and @mentions. Just like page and blog post comments, others can reply to, or like, your inline comments, and you'll be notified when they do.

You can also resolve inline comments once the conversation's finished, and reopen them at any time if they're needed.

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

View and reopen resolved comments

If you want to view and/or reopen resolved comments on a page or blog post, choose  > Resolved comments, then choose Reopen.

Link to a comment

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

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.

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.

36 Comments

  1. Is it possible to list the number of comments at the top of the page, with a link to the comment section (similar to the way the paperclip icon shows the number of attachments and links to the View Attachments page)?

  2. Is there any way to display the most recent comments first? And also, possibly, to place the comment box above the rest of the comments?

  3. When I share a blog post with a specific group of users, how can I ensure they are notified of ensuing comments? The standard set-up seems to require them to actively watch the post to be notified of comments. This results in some of the users who had the original post shared with them missing out on the conversation that follows.

  4. Hi there

    Would there be a way, or do you intend in the future, to make it possible to make inline comments to a page.
    That I know of, Confluence only admits general comments at the bottom of the page but then those are not contextual.
    Online comments would help the collaborative creation of a document (i.e. the way Google docs do)

    Thanks 

    1. I TOTALLY support this - VERY useful for collaboration on writing reference material - comments at the bottom of the page are not particularly intuitive if it is a big draft page - I describe like adding comments to a Word document https://answers.atlassian.com/questions/71149/popup-rollover-contextual-comments

      But no-one has voted on my request yet  CONF-26360 - creating rollover-pop ups in Edit mode Resolved

    2. Sacha Prohaczka and Rodney Hughes - The official feature request is here:  CONF-6368 - Inline Comments Resolved

      1. How can this be "Resolved" - do we have an inline comments facility available now??? - Please provide reference/examples and which version of Confluence is it available in

      2. Hum, the feature was supposed to be resolved in ....2006????
        Something I don't quite understand.

        Anyway Athlassian.. your product our great and integrate just real nice... but lately you are making tons of marketing around the collaboration part of Confluence which in many aspect is true but on some aspects, Confluence is falling slightly short.

        Online comment is one (you have add ons, true, but real expensive for a feature), another is that you always need to edit the document to work on it. For true collaboration, I am not sure the publish/edit barrier is needed, it might be better sometime to allow for direct editing view.

        Last but not least, it might be convenient when creating a new document with multiple hands to have a way to know who wrote what within the inline text... with a color scheme??? this really would bring collaboration to the next level.

  5. Anonymous

    Is it possible to add comments to a page or space that only admins can see and not general users? This would be very useful to our company.

    1. Hallo there

      Anyone who can see the page or space will also be able to see the comments on the page. It's not possible to hide comments from people who can see the page.

      Cheers, Sarah

  6. Hallo to everyone asking about displaying the most recent comments first

    There isn't an option in the default Confluence user interface, to change the order of comments. Here are a couple of options:

    I'll add the above information to the page.

    Cheers, Sarah

  7. Is there a way to grant users the ability to comment on specific pages without allowing them to comment throughout an entire space?

    1. Hi there, comments are enabled on a space by space basis. Confluence does not provide an option to enable or disable comments at the page level. You might find the workarounds suggested by the community on this issue helpful -   CONF-7742 - Allow comments to be disabled on a page or blog post Resolved

      Rachel

  8. Hello,

    Is it possible to ask for a user identification whenever they post a comment on the page?

    1. Hi Armon, the best way to do this would be to turn off the Add Comment permission for anonymous users. This means that anonymous users can view the page, but would need to be logged in to add a comment.  See Setting Up Public Access and Assigning Space Permissions for more info. 

  9. Hello,

     

    is it possible to post comments without sending notification to watchers, or can manually decide send notification or not. feature like edit page has two button (Save button , Save&Notify) ?

    Thanks


    1. Hi Rod, as far as I am aware adding a comment will send a notification to watchers.  Sorry!

  10. Hi

    Is there any possibilities to post a comment on page without notification!!

    1. why post a comment without people knowing about it???

      are you expecting them to find it by surprise some time in the future?

    2. I'm not aware of a way to turn off email notifications for comments. 

  11. Is there a way to hide the note to remind users to login or sign up? We do not want to support this method of login or signup.

  12. So there is no way to disable comments for individual pages? There are pages that should not allow or need the use of comments. For example, I don't want users to be able to add comments on the Contact Information page.

    A nice example is Google Sites. You can easily disable comments for each pages with a few clicks.

    1. Hi Evgenios, this is possible with a very simple user macro (we use it ourselves on a few pages here and there, such as the homepage for this Confluence site).

      This blog, by a Confluence user, has all the info on what you need to do to create the user macro more-flexible-commenting-in-atlassians-confluence.  You can also refer to Writing User Macros for the basics of creating a user macro. 

  13. Is it possible to disable editing or deleting of comments after they have been posted (except admins)?

    1. Hi Jon,

      You can revoke the 'delete comment' permission from a user or group (like the confluence-users group), so they can't delete other people's comments.

      If you want people to be able to add comments, they need to have the 'add comment' permission. They'll be able to edit their own comments, but not other people's.

      1. Thanks Giles. But is it possible to prevent users from even deleting their own comments (for compliance reasons)?

        1. Hi Jon,

          Unfortunately not. It was raised in the below issue, but the decision was made not to support this functionality at the moment. You can, of course, comment on the issue to add your voice, or raise a new issue requesting the functionality.

          CONF-35264 - Adding a fine permission setting to restrict the user from deleting their own comment Resolved

  14. I just want to say thanks for your wonderful post, it is contain a lot of knowledge and information that i needed right now. You really help me out my friend, thanks ! For more information about friv game, Friv 3

  15. I have read the preliminary information sharing, it is really good to me, I will read your blog regularly

    http://www.frivcom-frin.org/  |    http://firv-frivcom.org/   |  http://www.jocurifriv5.org/

  16. Hi,

    here a good plugin for deleting all or selected comments from a page:

    https://marketplace.atlassian.com/plugins/aptis.plugins.deleteAllComments

  17. Is it possible to view/approve comments before they appear on a page? 

    1. Hi Casey,

      Unfortunately there's no way to approve comments before they're posted. As you'll see from the below issue, it also doesn't look like this will change in future due to the added complexity of implementing it. (sad)

      CONF-13202 - Comments Approval Workflow Resolved

  18. kindly help me ..How to add a comment editor in JIRA - while adding the comment on issues.. like this editor 

    1. I'm glad you like our Confluence editor.  Unfortunately JIRA uses a plain text editor for comments. There's more information on this ticket, including information about some add-ons that may help  JRA-8943 - WYSIWYG / Rich Text Editor Open

  19. I would like to know what other writers are doing to work around the fact that they cannot edit their page in the same version of the page in which the comment they are looking to resolve is displayed. What is your preferred work-around to get your work performed on a day-to-day basis? Thank you.

  20. Is there a way to archive the comments on a page? Can I remove them easily or export them to a pdf/word?