Use Confluence's Attachments macro to show a list of attachments on the current page. Use the Space-Attachments macro to show a list of attachments in the current space. These both generate a table of attachments which is clickable. |
Using the Attachments Macros
To add the {attachments} or {space-attachments} macro to a page:
- In the Confluence editor, choose Insert > Other Macros.
- Find and select the required macro.
Attachments Macro Parameters
When editing, you can click on the macro placeholder and choose Edit to display the parameters for this macro in the Macro Browser.
Parameters are options that you can set for Confluence macros to control the content or format of the macro output. The table below lists parameters for this macro that can be set in the Macro Browser.
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 |
Include Old Attachment Versions | false | Include 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:
|
Allow Upload | false | Provides the ability to browse for, and attach, new files. |
Viewing and Editing Files from the Attachments Macro
If an attachment is an Office or PDF file, you will see a View link as shown in the screen snippet below. Furthermore, if the attachment is an Office file, it will also have an Edit link.
Screenshot: Office and PDF file page attachments showing the 'View' and 'Edit' links
Click View to view the content of the Office file within Confluence.
Click Edit to edit the content of the Office file in your Office application. You must have a compatible Office application installed to do this. Refer to Working with the Office Connector for more information.
Attachment Information Icon
When a page you are viewing contains attachments, a small paperclip icon appears next to the page byline. Clicking the paperclip will take you to the 'Attachments' view, where the full list of attachments is displayed.
Space Attachments Macro Parameters
When editing, you can click on the macro placeholder and choose Edit to display the parameters for this macro in the Macro Browser.
Parameters are options that you can set for Confluence macros to control the content or format of the macro output. The table below lists parameters for this macro that can be set in the Macro Browser.
Parameter | Default | Description |
---|---|---|
Space | blank | Selects the Confluence space to display all attachments for. If no space is specified, the current space will be used. |
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). |
Notes
The macro can only list the attachments on the current page. It is not possible to display attachments from another page. If you are interested in this feature request, please watch or vote for CONF-6351.
Related Topics
Working with Attachments
Working with Macros
Take me back to the Confluence User's Guide.
Attachments:




