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, select Insert , then 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 behavior of a macro.

To change the macro parameters:

  1. In the editor, click the macro placeholder and select Edit.
  2. Update the parameters as required then select 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 May 20, 2020

Was this helpful?

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