An attachment is a file that is included with your page. Examples of attachments are screenshots, photographs, other images, Word documents, presentations, PDF documents, videos and sound files. Your page can display a list of attachments – these may be the files that are attached to the page or to any page in the space. Use the Attachments macro to show a list of the attachments on the current page. Use the Space Attachments macro to show a list of the attachments in the current space. Both these macros generate a table of attachments which is clickable. Using the macrosTo add the Attachments or Space Attachments macro to a page:
Speeding up macro entry with autocomplete: Type { and the beginning of the macro name, to see a list of suggested macros. Details are in Using Autocomplete. To edit an existing macro: Click the macro placeholder and choose Edit. This will display the parameters of the macro in the Macro Browser. |
Parameters of the Attachments macro
Parameters are options that you can set to control the content or format of the macro output.
Parameter | Default | Description |
|---|---|---|
Filename Patterns | all | Filters the attachments to display, using a comma-separated list of regular expressions. So, to match a file suffix of 'jpg', use |
| Attachment Labels | (none) | Filters the attachments to display, based on a list of labels. If you wish to enter more than one label, separate the labels with commas. Confluence will show only attachments that have all the labels specified. (The match is an AND, not an OR.) For information on labelling the attachments, see Adding Labels. |
Include Old Attachment Versions | false | Includes previous attachment versions in the list. |
Sort By | date | Specifies the sort order for attachments. Note that people viewing the page can change the sort order by clicking the column headings. Valid values are:
|
| Sort Order | ascending | Use this parameter with the Sort By parameter. You can choose to sort the attachments in ascending or descending order. |
Allow Upload | true | If selected, the list of attachments will include options allowing users to browse for, and attach, new files. |
| Page Title | (none) | Use this option to to display attachments from another page. If you do not enter a page title, the macro will display the files attached to the current page. |
Viewing files and changing file properties from the Attachments macro
The list of files displayed by the Attachments macro includes options for viewing the files and other actions, provided the user has the relevant permissions. If you have specified the 'Allow Upload' parameter, users will be able to upload attachments directly from the list too. Users can also remove attachments or edit attachment properties and labels. If an attachment is an Office or PDF file, you will see the appropriate options for Office Connector files.
Screenshot 1: The Attachments macro

Parameters of the Space Attachments macro
Parameters are options that you can set to control the content or format of the macro output.
| Parameter | Default | Description |
|---|---|---|
| Space | (none) | Selects the Confluence space to display all attachments for. If no space is specified, the current space will be used. |
| Attachment Labels | (none) | Filters the attachments to display, based on a list of labels. If you wish to enter more than one label, separate the labels with commas. For information on labelling the attachments, see Adding Labels. |
| Show Filter Controls | true | Determines whether or not the filter panel is shown. The filter panel allows you to filter the list of attachments by file type (extension). |
Screenshot 2: The Space Attachments macro
