Edit an image before inserting

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

Selecting exactly one page attachment or Unsplash photo in the insert dialog and pressing Insert raises a prompt offering to edit first, opening the 'Edit image' screen ('Annotate or edit before inserting'). Images over 3 MB cannot be edited.

Pressing Insert on a single attachment or stock photo raises this choice before anything reaches the page.

#Where you do it

Edit image screen showing a screenshot marked up with red, green and blue callout boxes, a tool rail on the left, a colour palette on the right, and Back and Insert image buttons.
Crop, boxes, arrows and text are applied on the copy that goes onto the page, and Insert image commits 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

-

#Worth knowing

  • A reader who cannot see the folder's space usually sees 'No images in this folder' rather than a permission notice, because Confluence filters search results by permission instead of refusing the query.

  • Show Caption prints the library asset's own title (or description) on the page, not the Image Title stored on the macro. The published-site exporter behaves the opposite way. It prefers the macro's Image Title and falls back to the asset title.

  • Newly inserted galleries and galleries created by pasting a folder link do not look the same. Inserting from the macro browser applies the insert defaults (corner radius 8, gap 16, small shadow) plus any tenant brand guidelines; a pasted link rebuilds the config from the plain defaults (corner radius 6, gap 12, no shadow). This default split affects the gallery only. For the Image reference macro

  • Corner radius, Shadow and Border on the reference macro, and Columns, Image fit, Gap, Corner radius, Shadow and Border on the gallery, exist only in the custom config panel.

  • An image picked through the shared image picker (Formatting Banner, Cards, Gallery, Compare, Background) is stored as a plain URL, not as a reference. Those macros 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.

  • The 'Capable Images' section in the shared image picker, and the Markdown 'From library' item, are contributed by Images but consumed by Formatting and Markdown. The standalone Images app bundles neither, so both seams are Suite-only in practice.

How it actually behaves.