Image reference

Pins one image from the Capable Images library onto the page and always shows its latest version. Replacing the file in the library updates every page that references it.

A Confluence editor with an Image Reference (Capable) macro selected, containing a blue Capable banner, and a floating toolbar below it offering edit, an alignment menu set to Centered, copy and delet
Alignment is chosen from the toolbar beneath the macro, alongside the edit, copy and delete controls.

#Configuration

Setting

Values

Image

Any image in the Images library. An uploaded file, an Unspla

Image Title

Free text

Width (px)

Any whole number, or blank ('Auto'). A stored value of exact

Height (px)

Any whole number, or blank ('Auto'). A stored value of exact

Aspect Ratio

Original | 16:9 | 4:3 | 1:1 | 21:9

Alignment

Left | Center | Right

Show Caption

On | Off

Corner radius

0–24 px slider

Shadow

None | S | M | L (stored as none | sm | md | lg)

Border

Off | On; width 0 to 6 px; colour = hex or a brand colour


#Updating the source image

Click on the image in the library and click ‘Upload’ to replace it with a new version.

All pages that reference this image will reflect the change immediately.

Image detail toolbar with the Upload button hovered and a tooltip reading Upload new version.
Upload on an image's detail screen replaces the file, which is how one upload refreshes every page that references it.


One macro, documented properly.