Image reference macro

The Image reference macro is a useful feature that allows you to store an image in your library and then reference that same image across multiple pages. This functionality makes it very convenient to manage images because you only need to update the image once in the library, and all pages that reference it will automatically reflect the change.

This approach saves time and effort when maintaining consistency across your content, especially if the image needs to be updated or replaced at a later date.


#Copy from the library

#1. Open an image in your library and click ‘Copy as macro’

Copy an image as a reference macro

#2. Paste this onto a page to embed the image on a page


#Insert from a page

#1. Type /image and select ‘Image’

Insert Image Macro in Confluence

#2. Select the images to embed

You can search across your image library for the images you want to insert.

Click Insert References to keep images in sync

#3. Click ‘Insert Reference’

This will insert a new macro on the page which contains the referenced image. You can configure the dimensions and aspect ratio from the macro configuration.

Image Reference Macro in Confluence

#4. Update images all at once

From the ‘Images’ app page, you can click ‘Upload’ on an existing image to update it centrally and have it synchronised across all pages.

Update an existing image in the library