Documentation for Confluence 5.4.
Documentation for Confluence OnDemand and earlier versions of Confluence is available too.

Skip to end of metadata
Go to start of metadata

A comment is a remark, question, or any other additional information you wish to add to a page or blog post. People can use comments to interact with each other on your Confluence site.

You can add a comment to any page or blog post, provided that you have the 'Add Comments' permission in the space. You can also show that you agree with or enjoyed someone else's comment, by liking it.

Comments are displayed at the bottom of the page, below the page content. They appear in one of two views, configured globally by a site administrator:

  • Threaded – This view shows the comments in a hierarchy (tree) of responses. The replies are indented to indicate the relationships between the comments.
  • Flat  – This view displays all the comments in a single list and does not indicate the relationships between comments.

On this page:

Related pages:

Adding a comment

You can add a comment on pages and blog posts in Confluence. To add a comment, you need the 'Add Comments' permission. See Space permissions.

To add a new comment:

  1. Type your comment in the comment field at the bottom of the page. 
  2. Choose Preview to see how your comment will appear.
  3. By default, Watch this page is ticked.This means that you will start receiving notifications about this page. Uncheck this if you do not want to watch the page.
  4. Choose Save.

You can also highlight any text on a page, and choose the Quote in Comment button that appears near your selection. This will add the highlighted text into the comment field, apply the Quote style, and leave the cursor in the comment field ready to type a comment.   If you do not see a popup when you highlight text, check that Text Select is enabled in your profile settings. 

To respond to a comment:

  1. Choose Reply located below the text of a comment.
  2. Type in your response.
  3. Choose Save.

To reply to comments, your Confluence site must display comments in threaded view.

Editing a comment

To edit a comment, you need the 'Add Comments' permission. See Space permissionsSpace administrators can edit all comments within their space. The date on a comment always indicates the time the comment was last edited.

To edit a comment:

  1. Go to the comment and choose Edit.
  2. Make changes to the comment just as if you were adding a comment.
  3. Choose Save.

Deleting a comment

To delete a comment from a page, you need the  'Remove Comments' permission. See Space permissions.  Deleted comments cannot be restored.

To delete a comment:

  1. Go to the page that contains the comment.
  2. Choose Delete at the bottom of the comment box.

If you do not have 'Remove Comments' permission, you are able to delete your own comments, but only if there are no replies to the comment. 

Linking to a comment

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

Disabling comments

To prevent all users from adding comments in a space, remove the 'Add Comments' permission from the 'confluence-users' or 'users' group, anonymous users and all other users and groups. See Space permissions. The option to add comments will no longer appear on pages or blog posts. You need to be a space administrator to change the space permissions.

There is no permission that controls comments across the entire site.

Notes

  • You can choose Tools > Watch to receive an email notification whenever anyone edits the page or adds a comment to the page.
  • Your profile picture will appear next to each comment that you have added. (This is true if your space uses the Confluence Default theme.)
  • On blog posts only, an 'Author' lozenge will appear on any comments made by the original author of the post. 
  • Comments are not auto-saved. See feature request: CONF-12978 - Add auto-save/draft feature for comments Open
  • It is not possible to delete all comments for a page simultaneously.
  • Individual users can choose to disable the Text Select popup that is used to enable quote in comment. See Editing User Settings.
  • There is no option in the default Confluence user interface, to change the order of comments. For example, it is not possible to show the most recent comments at the top. Here are some options to investigate:

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