Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

File options: File lists vs page attachments

Can anybody comment on the pros and cons of different Confluence file management options? There are space File lists and attachments to pages. I'm not sure when it's best to use one vs the other?

1 comment

Zak Laughton Atlassian Team Jul 24, 2018

Hi Ned!

Attaching files to pages is preferred when you have a few attachments that are related to the content of a page. Users might not typically search for these files on their own, but they are useful in the context of the page. Some examples might be screenshots on a page or a few files linked on the page. 

The File list blueprint is useful when the files are the main content. It's meant to be used when you have a list of files to share with people. As an example, you might have a set of Microsoft Office templates, or a central location to store all your team presentations.

It may help to consider that the attachments in a file list are still just attachments on a page. For example, if you have a "Presentations" file list, all files on that list are attachments to that same "Presentations" page, displayed in an Attachments macro. The benefit of the file list blueprint is that these lists are easily generated and accessible from the sidebar.

So to sum it up: Regular ol' attachments on a page are good to supplement content on a page, and file lists are good for sharing lists of files easily accessible from the sidebar. If you have any use cases in-between, you can also include the Attachments macro on any page to feature a list of attachments.

That's a great explanation and helps tremendously. Thanks!

Like Kimber Miller likes this


Log in or Sign up to comment
Community showcase
Published in Confluence

Confluence: Where work and wellness meet

Feeling overwhelmed by the demands of work and life? With a 25% increase in the prevalence of anxiety and depression worldwide during the pandemic, for most of us, it’s a resounding yes . 🙋‍♀️ ...

846 views 10 24
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you