• Products
  • Documentation
  • Resources

Insert the space attachments macro

This macro was intentionally excluded from the new editor and will be deprecated from the legacy editor soon. Read the announcement for more information. 

The Space Attachments macro displays a list of all files attached to pages in a space. It shows details of the file and includes a link to the page a file is attached to. 

Filters allow you to show only files with a particular label or file extension. 

Use the Space Attachments macro

To add the Space Attachments macro:

  1. When editing , select from the toolbar

  2. Find the item to be inserted and select it

  3. Select Insert

You can also type / on the page to bring up the same list you'd see by selecting from the toolbar.

To edit the Space Attachments macro:

  1. Select the macro placeholder. The floating toolbar appears.

  2. Select Edit. The right panel opens.

  3. Modify the parameters. Your changes are saved as you go.

  4. Resume editing the page, and the panel closes.

Parameters

The Space Attachments macro displays a list of all the attachments in a space. You can choose to show attachments from the current space, or another space. 

Parameters are options that you can set to control the content or format of the macro output. 

If the parameter name used in Confluence Cloud storage format or wikimarkup is different than the label used when inserting macros using the browser or the slash command, it will be listed below in brackets (example).

Parameter

Default

Description

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) 

true

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

Wiki markup example

Wiki markup is useful when you need 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.

1 2 3 4 {space-attachments:showFilter=false|space=ds}

 

Additional Help