Asset reference picker (other surfaces)

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

Any surface can open the images library to pick a referenceable asset through the generic asset-reference field, labelled 'Select an image'.

#Note

In reference-picker mode the catalogue is narrowed to library sections only. Page attachments and Unsplash results are hidden, because a reference URL cannot resolve them, and the picker refuses one with 'Not a library image'.

#Where you do it

Task

Where

Add a stock photo to the library

Images library → Stock images → search → drag a result onto a library folder

Put a single library image on a page

Editor → type / → 'Image reference (Capable)' (Suite) or 'Image reference macro (Capable)' (standalone)

Put a library image on a page by pasting a link

Editor → paste the image's Capable asset URL

#Settings that affect this

Setting

Where

What it does

Global settings → Asset access (Permissi

Capable settings → Asset access

-

Global settings → Indexing

Capable settings → Indexing

-

Global image library space

Confluence space with the key CAPABLEASSETSTORE, named 'Capable Asset Store'

-

#Limits that apply here

Limit

Value

What happens

Stored asset title length

50 characters

The filename is truncated when building the stored title.

Stored asset description length

250 characters

An Unsplash caption plus author credit can be cut mid-sentence.

PDF/Word export default width

760 px when the Image reference macro ha

-

#Worth knowing

  • Asset descriptions are silently truncated at 250 characters and stored titles at 50, so an Unsplash caption plus credit can be cut mid-sentence.

  • Cancelling the auto-opened picker on an 'Image (Capable)' placeholder leaves the macro on the page showing a 'No Images Selected' card. Visible to readers, not just the author. And the picker will not reopen automatically for the rest of that browser session. Because that macro has no unlicensed access grant, an unlicensed or anonymous reader sees nothing there at all.

  • There is no migrator for the legacy standalone image library macro. Only three migrators exist. The library, the Image reference macro and the Image folder gallery macro.

  • In non-production environments, licensed-only triggers are dropped, so image reference indexing does not run at all unless the environment declares a licence override.

Better with company.