# Shared image picker (Formatting macros)

The Images capability contributes a 'Capable Images' accordion section to the shared image picker used by the Formatting Banner, Cards, Gallery, Compare and Background macro configs. It searches the current space library and the global library together.

---

## Important

On select it hands back a direct, persistable image URL. Never a live Capable reference. Those macros therefore never follow later library edits, and if the library image is deleted the macro is left pointing at a dead URL with no notice at all.

---

## Availability

Suite in practice. The section is contributed by Images and consumed by Formatting; the standalone Images app bundles no Formatting capability, so there is nothing there to consume it.

---

## Where you do it

| **Task**                  | **Where**                                                                                 |
| ------------------------- | ----------------------------------------------------------------------------------------- |
| Open the image library    | Confluence space or global apps menu → 'Capable Images' (standalone) or 'Capable' (Suite) |
| Create a folder           | Images library → Space images or Global images → new folder control                       |
| Rename or delete a folder | Folder context menu in the library navigation                                             |

---

## Settings that affect this

| **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**                                                                                                                                                                                        |
| ------------------------------------------ | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Upload. Drag and drop accepted extensions. | Bmp, gif, ico, jfif, jpeg, jpg, png, svg | Anything else raises 'Invalid file type. Only image files are allowed'.                                                                                                                                 |
| General image compression target           | 5 MB and 2500 px on the longest side     | \-                                                                                                                                                                                                      |
| Editor / attachment-import fetch ceiling   | 3 MB                                     | An attachment loaded for editing or importing into the library is capped at 3 MB of raw bytes. Larger files are auto-resized to PNG to fit; only if that still fails does it error 'Image too large for |

---

## Worth knowing

* Standalone Images has no space settings screen, so there is no per-space configuration surface of any kind in that app.
* The Indexing tab is not available in standalone Images, so there is no way to force a reindex there when the search index lags.
* The Migration tab never appears for the Images app. Standalone-to-Suite migration is started from the Suite side.
* Customer-managed egress domains are unavailable in standalone Images. That app declares no external permissions block at all.
* Images cannot be turned off per space from the released UI. The Space settings screen only shows the Auto/Always/Never control for capabilities that can be pinned to the nav bar, and Images cannot be pinned, so its row is a static 'Available from Capable Menu' badge. The standalone byline's display condition does still read a per-space off-switch property, but no released screen writes it. And the
* There is no Capabilities (global hide) tab in the standalone Images app, so a standalone customer cannot hide the capability instance-wide from the app either.

---

## Related

[Asset reference picker (other surfaces)Another connection.](https://help.gocapable.com/images/asset-reference-picker-other-surfaces.html)

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

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

---

_Better with company._