Documentation for Confluence 5.8 (Server).
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, 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)

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).

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

Resolve inline comments

Hit Resolve to hide a set of inline comments once the conversation's finished. If you want to view resolved comments, choose  > 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 Working with 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.

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.


  • 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.


  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)


    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

      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


  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) ?


    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  |   |

  16. Hi,

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

  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?

    1. Hi Twafik,

      Unfortunately you can't archive or resolve page comment at this point. You can watch and comment on the following issue if you'd like to add your support for this functionality.

      CONF-30106 - Mark page comments as resolved to hide them New


      There's no way to mass delete or export them in the UI, but you could try asking over at answers as there may be a way via the REST API.

      1. Hi @Giles Brunning ,

        Unfortunately you can't archive or resolve page comment at this point

        I would like to remove a page and move its comments to another page: could you confirm that is not possible?

        So, what is the best alternative?

        Thanks in advance,

        1. Hi Nicolas,

          There's unfortunately no way to move comments from one page to another, short of copying them (whether that's a manual copy/paste, or via the REST API).

  21. 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.

  22. Rachel, are you going to add information regarding comments on attachments (new in 5.7) to this page, or where can we find the related documentation, i.e. on the new viewer) already, besides of the 5.7 Release notes ?

    1. Hi Hans-Peter,

      You can find the file comment info here: Collaborating on Files.

      There'll be a link to it on this page next time we publish.

  23. Are there plans to allow inline comments on any text that is on a page?  I am trying to add a comment on a section heading (H1/2/3/4/etc) and am getting the follow error displayed

    "We can't add your inline comment; the section you highlighted may contain a macro or user mention. Try highlighting plain text."

    I am trying to suggest renaming the section.

    1. Hi Dave,

      The short answer is, yes, we're working on reducing the circumstances in which you'll encounter that error. Unfortunately I can't give a timeframe, but it's on our radar.

  24. Hi,

    Is there any limit about attachment size for a comment.I configured "2,048.00 MB" in General Configuratioin.When I try to add an attachment of size 470kb for a comment using Insert > Attachment option I get an error "Could not upload the file to Confluence. The server may be unavailable."

    But the same attachment I'm able to add to page using Tools > Attachments option.

    Is there any limit on maximum size of attachment to be added for a comment?

    If so where we can change the attachment size?

    Please help 



  25. Is there a way I can list inline comments or jump to next/previous or step through them, in a similar way to the review functions in Microsoft Word?

    1. Hi Adam, there isn't currently a way to list all comments, but you can navigate through them in order using the up and down arrows on the top of each comment (see below), or using the keyboard shortcuts, N (next) and P (previous).  Hope this helps (smile)

      1. That'll do the job nicely! Many thanks. (smile)

    2. mb

      +1 for the list! Didn't find any makro for this.

      I like inline comments a lot, but they`re not yet really as good as they could be.

      • email to author/watchers in case of a new inline comment is not a proper way to make sure they resolve their comments
      • it is not efficient to "search" for any comments overlooking the whole page. Also to use the "next/previous" comment one has to find the first one before!
      • In the menu one can find "resolved comments", but not "UNresolved comments"
      • there is no macro to show the comments summarized on a page
      • "tasks" are not working within comments
      • the status of a page (hasUNresolvedComments) would be good to be visible on top of the page
      • there seems to be a conceptional mixture between page comments and inline comments as inline comments are not shown on the end of the page and the "resolving"-idea is only implemented for inline comments, not for page comments where it would make sense too. Atlassian could also add a access to the inline comments to the page comment area on the end of the page

      To have a better overview for the review process one definitely needs a macro to list the inline comments!

      Hope inline comments are being improved as they could be really helpful!!!

  26. Hi Adam Thomson, we can list inline comments, there wont be any approval / reject option in the comment editor.But this is a good idea. we can expect in next versions. 

  27. I saw a reference to disabling inline comments, but I can't find how to do that. Can someone please point me to a doc?

    1. Hi Charley,

      We don't produce doc on disabling inline comments, as it's not really recommended use. If you do need to disable them, though, there's a Confluence Inline Comments system plugin that you can disable.