Attachments

The macro can show images and link to files that are already attached in Confluence, on the current page or anywhere on the site.

Insert an attachment

1. In the macro editor, click Insert an attachment (the image icon) in the toolbar.
2. Choose This page or Whole site. The picker starts on This page, and switches to Whole site if the page has no attachments.
3. Search by name, or filter by type.
4. Click an attachment to add it.

Images are embedded, and other files are added as links. The Markdown is added at the end of the editor; move it where you want it. Use Load more to see more results and Refresh to pick up files uploaded while the picker was open.

What gets inserted

An image:

![diagram.png](https://your-site.atlassian.net/wiki/download/attachments/... "width=100% height=auto")

Any other file:

[report.pdf](https://your-site.atlassian.net/wiki/download/attachments/...)

Image size

Change the width and height in the image title, using any CSS size:

![diagram.png](https://your-site.atlassian.net/wiki/download/... "width=400px height=auto")

Images are never wider than the macro.

Limitations

• Images and files must be attached in Confluence. Because of Atlassian's data egress rules, images from outside URLs aren't supported.
• The picker is in the macro editor only. In Edit with Markdown, uploaded images and files are kept as they are, and you can add images by web address with ![alt](https://...).
• In PDF and Word exports, images become links. See Search and export.