Share and Comment on Files

Still need help?

The Atlassian Community is here for you.

Ask the community

Collaboration doesn't just happen on pages; often you'll need to collaborate with your team on documents, presentations, images and spreadsheets. Whether it's mockups for a new marketing campaign or a full project plan, you can simplify your team's feedback loop by working together on files in Confluence. 

Share a file

Do you have lots of files on a page and want to get a team member's input on just one of them? You can share the file with them directly. 

It works just like sharing a page:

  1. Click the thumbnail or link to preview the file.
  2. Choose the Share button.
  3. Enter an email address, user name or group name, add your message and send.

Your team members will get an email with your message and a link to view the file.

Share notifications are only sent by email, they won't appear in the workbox .

Comment on a file

Whether it's an image – like a mockup of the new marketing campaign that needs feedback – a PDF, a presentation, or any other file you can preview in Confluence, you can drop a pin anywhere on the preview and add your comment to start a conversation.

To comment on a file:

  1. Click the thumbnail or link to preview the file.
  2. Drag the pin icon from the bottom of the preview and drop it where you want to comment.
  3. Add your comment and Save.

Pinned comments work just like inline comments on pages. You can use @mentions and links, and drop as many pins as you need on any part of the file. You can even add simple macros such as the code macro using wiki markup autocomplete. Anyone with permission to add comments to the page can add and reply to comments on a file.

When you preview a file, you'll see pins for any existing comments on that version of the file. Select a pin to view the comment.

Once the conversation is finished, you can resolve the comment to hide it (and any replies) from view. If you need to see resolved comments again, you can reopen them. Go to > Resolved comments in the preview.

  1. Resolved comments: Choose the 'more options' button to show or hide resolved comments.
  2. Comments: Drag a pin onto a file to comment.

You can't comment on files that are hosted on a web server and added to Confluence using their URL, or on files that can't be viewed in the preview (such as videos, zip files, and some other file types).

What happens to comments when you upload a new version? 

Comments are specific to the version of the file. This is to avoid confusion when the part of the document or image the comment is pinned to has changed significantly. 

To see inline comments on a previous version of the file:

  1. Click the thumbnail or link to preview the file.
  2. Click the filename dropdown in the top left and select a previous version.
  3. Comment pins will now be visible, for all comments made on that version. 

How many comments can you add to one file?

While there is no limit to the number of comments that can be added to a file, Confluence can only display 100 comments. See  CONFSERVER-43397 - Getting issue details... STATUS  for more information.  

Last modified on Dec 14, 2018

Was this helpful?

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