Image reference

Updated
View as text
Open in Confluence
Open in ChatGPT Open in Claude

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.

Image Reference macro selected in the editor, with a toolbar below offering edit, alignment set to Centered, copy and delete
Pick the alignment from the toolbar beneath the macro. Edit, copy and delete sit alongside it.

#Configuration

Setting

Values

Image

Any image in the Images library, such as an uploaded file or an Unsplash photo.

Image Title

Free text

Width (px)

Any whole number, or leave blank for Auto.

Height (px)

Any whole number, or leave blank for Auto.

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

Border

Off | On. Width 0 to 6 px. Colour is a hex code or a brand colour.

#Updating the source image

Open the image in the library and click Upload to replace it with a new version.

Every page that references this image shows the change straight away.

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. That one upload refreshes every page that references it.

One macro, documented properly.