• 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 macro by name and select it

  3. Configure it as needed

You can also type / on the page to bring up the same list you'd see by selecting from the toolbar. Continue typing the name of the macro to filter the list.

To edit the Space Attachments macro:

  1. Select the macro placeholder.

  2. Select the Edit icon to open the configuration panel.

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

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

You can also select the centered , medium-width , and full-width icons to adjust the width of some macros. Select the trashcan iconto remove the macro.

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 what and how content from the macro appears on the page. 

If the parameter name used in Confluence Cloud storage format 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}

 

Still need help?

The Atlassian Community is here for you.