Space Attachments Macro

Add the Space Attachments macro to a page to display a list of all files attached to pages in the current space, or another space. 

This is great for:

  • design assets
  • frequently used files, like forms
  • image libraries.

It shows details of the file and the includes a link to the page the file is attached to. Filter the list by label or file extension to find the file you're looking for more easily. 

On this page:

Screenshot: A page containing the Space Attachments macro, to provide quick access to files used in a project. 


Add this macro to your page

To add the Space Attachments macro to a page:

  1. From the editor toolbar, choose Insert > Other Macros.
  2. Choose Space Attachments from the Confluence content category.
  3. Enter any parameters.
  4. Choose Insert

You can then publish your page to see the macro in action. 

Screenshot: Configuring the Space Attachments macro to only show files attached to pages in a specific space. 

Change the macro parameters

Macro parameters are used to change the behaviour of a macro.

To change the macro parameters:

  1. In the editor, click the macro placeholder and choose Edit.
  2. Update the parameters as required then choose Insert.

Here's a list of the parameters available in this macro. 

ParameterDefaultDescription
Space(none)Selects the Confluence space to display attachments for. If you do not specify a space, the current space will be used.
Show Filter Controls
(showFilter) 
trueDetermines whether or not the filter panel is shown. If you select this option, people viewing the page will be able to filter the list of attachments by file type (extension) and by label.

Where the parameter name used in Confluence storage format or wikimarkup is different to the label used in the macro browser, it will be listed below in brackets (example).

Other ways to add this macro

Add this macro as you type

Type followed by the start of the macro name, to see a list of macros. 

Add this macro using wiki markup

This is useful when you want to add a macro outside the editor, for example as custom content in the sidebar, header or footer of a space.

Macro name: space-attachments

Macro body: None.

{space-attachments:showFilter=false|space=ds}
Last modified on Aug 22, 2023

Was this helpful?

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