Working with other capabilities
Images works best alongside the rest of Capable. This page sums up each connection, and each one has its own page with the detail.
If a connection doesn't exist, we've listed it anyway so you can stop looking.
#Every connection
Connects to | What you get |
|---|---|
Shared image picker (Formatting macros) | Images adds a 'Capable Images' section to the image picker used by the Formatting Banner, Cards, Gallery, Compare and Background macros. It searches the current space library and the global library together. |
Asset reference picker (other surfaces) | Any other part of Capable can open the images library so you can pick an image to reference. The field is labelled 'Select an image'. |
Markdown 'From library' | Adds a 'From library' item to the Markdown image insert menu. The image you pick stays linked to the library, so it does follow later library edits. |
Auto-convert on paste | Paste a link to a library image and it becomes an Image reference macro. Paste a link to a library folder and it becomes an Image folder gallery. |
CQL search on library images | Library images have nine searchable fields in Confluence's CQL builder: Asset title (~), Asset description (~), Asset category (=), Asset author (=), Asset template (=), Asset capability (=), Asset type (=), Asset feature (=) and Asset tags (=). |
Page reference index | Every image an Image reference macro points at is recorded on the page, under an 'Image References' field you can search with CQL. This is what powers the 'Used on Pages' panel. |
PDF and Word export | Images are built into the exported file. If one can't be included, you'll see a yellow warning panel instead of a broken image. |
Published Capable Sites | Image reference exports fully. The file is copied into the site, and alignment, caption, corner radius, shadow and border are kept (Width, Height and Aspect Ratio are not). Image folder gallery shows an explanatory note. The Image library placeholder shows nothing. |
Rovo chat agent | Both apps include an agent that can work with library images. Standalone: 'Capable Images' (images only), with the conversation starters 'Find relevant images from library', 'Insert an image onto the page' and 'Find images in the brand folder'. Suite: 'Capable Agent', which covers diagrams, markdown and more. |
Unsplash | Stock search goes through Capable's own service rather than straight from your browser to Unsplash, using your app sign-in. |
#The pages
Shared image picker (Formatting macros)
The Images capability contributes a 'Capable Images' accordion section to the shared image
Asset reference picker (other surfaces)
Any surface can open the images library to pick a referenceable asset through the generic
Markdown 'From library'
Adds a 'From library' item to the Markdown capability's image insert menu. Picking an imag
Auto-convert on paste
Pasting https://assets.app.<zone>/<hash>/assets/images/assets/<id> becomes an Image refere
CQL search on library images
Library images ship nine searchable fields you can use in Confluence's CQL builder: Asset
Page reference index
Every image an Image reference macro points at is recorded on the page under an 'Image Ref
PDF and Word export
It downloads the picture with app authority and inlines it as a data URL, because an exter
Published Capable Sites
Image reference exports fully. The file is copied into the site and alignment, caption, co
Rovo chat agent
Both apps ship an agent that can work with library images. Standalone: 'Capable Images' (i
#A few things worth knowing
A connection needs both apps installed. In a standalone app, most of these don't exist.
Anything that relies on search only reflects pages that have been indexed.
Published sites show Capable macros properly, which is where several of these connections pay off.
#Related
Better with company.
