Two insert modes

'Insert N references' places Image reference macros (live links). 'Insert N images' places native Confluence image nodes (frozen copies that render in exports and for logged-out readers). The references button is disabled whenever any non-library item is selected.

#Where you do it

Insert dialog with three library images ticked and footer buttons reading Clear selection, Insert 3 references and Insert 3 images. — With three images ticked the footer offers both routes, references that stay linked to the library or copies frozen into the page.

Task	Where
Create a gallery by pasting a folder link	Editor → paste the folder's Capable asset URL
Style a gallery grid	Image folder gallery config panel → Style tab
Upload and insert images directly from the editor	Editor → type / → 'Image (Capable)' (Suite) or 'Images macro (Capable)' (standalone)

#Settings that affect this

Setting	Where	What it does
Catalogue view modes	Any library section	-

#Worth knowing

Confluence editor showing an Image Reference (Capable) macro rendering a Capable banner, with a floating toolbar offering edit, Centered alignment, copy and delete. — A reference lands on the page as its own macro node with alignment and edit controls, not as a plain image.

An image edited before insert is limited to 3 MB, matching the server's editor read cap.

Copy as macro

Another part of how this works.

Set an image as a page cover

Another part of how this works.

How it works

The rest.

How it actually behaves.