# Asset reference picker (other surfaces)

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.

---

## Related

[Markdown 'From library'Another connection.](https://help.gocapable.com/images/markdown-from-library.html)

[Auto-convert on pasteAnother connection.](https://help.gocapable.com/images/auto-convert-on-paste.html)

[IntegrationsEvery connection.](https://help.gocapable.com/images/integrations.html)

---

_Better with company._