Capable macro (Banner, Cards, Gallery, Compare, Background) stopped showing its image after I update

What you are seeing

A Capable macro (Banner, Cards, Gallery, Compare, Background) stopped showing its image after I updated it in the library


#Why it happens

The shared image picker stores a direct URL, not a live reference. Those macros never follow later library edits, and if the library image is deleted they are left pointing at a dead URL with no notice at all.


#What to do

Re-pick the image in the macro's config. If you need an image that follows library edits, use the Image reference macro or a Markdown 'From library' insert instead.


#Settings involved

Setting

Where

What it does

Global settings → Capabilities

Confluence admin → Apps → Capable → Settings → Capabilities

-

Global settings → Asset access (Permissi

Capable settings → Asset access

-

Global settings → Egress

Capable settings → Egress

-


#Limits that apply here

Limit

Value

What happens

PDF/Word export default width

760 px when the Image reference macro ha

-

Attached images sweep. Accepted file extensi

Jpg, jpeg, png, gif, bmp, svg, webp, tif

AVIF, HEIC, ICO and JFIF attachments never appear. The sweep also excludes the CAPABLEASSETSTORE space, generated thumbnail files, and Capable's own library images.

Unsplash search debounce and failure ceiling

500 ms debounce; gives up after 5 consec

Search does not go to Unsplash from the browser. It calls Capable's own API with the viewer's app token.



Found it? Good.