How it works
Capable Images gives Confluence a proper image library. Images live in two places: a per-space library, and one site-wide "Global" library.
#In this section
Two-tier libraryA per-space library ('Space images'. 'View images that have been uploaded to this space') and one site-wide library ('Global images'. 'View images that have been uploaded to the global space'), plus a read-only 'Stock images' section backedFoldersA single flat level of folders per library. Create, rename, delete, and drag images between them. All three folder operations are gated on the same permission check as uploading.UploadUpload button, or drag files anywhere onto a library section. Multiple files are processed one at a time with a progress toast. The original file is stored byte-for-byte; a separate downscaled thumbnail is generated alongside it. If a fileImport a page attachmentDrag a result from 'Attached images' onto a library section or folder. This imports a copy. It does not move or link the attachment. The bytes are fetched server-side because the browser cannot read attachment binaries cross-origin, and anyImport an Unsplash stock photoDrag a stock result onto a library folder. The photo is downloaded and stored as a library image, with the caption plus an author credit line ('Photo by <name> on Unsplash (<link>)') saved as the description.Move an imageDragging a library image onto another folder moves it. Dragging a non-library item (attachment or stock photo) imports a copy instead.EXIF and metadata captureOn upload, EXIF is read (skipped for PNG, SVG and PDF/AI/PSD) and stored: camera make, model, capture date, lens model, creator tool, width and height, plus a derived orientation. Landscape above a 1.1 ratio, portrait below 0.9, otherwise sVersion an image in place'Upload new version' on an image's detail page. Every Image reference macro and every Markdown 'From library' reference picks up the new version. Native inserted copies keep the bytes they were given.Used on PagesA panel on each image's detail view listing the pages that reference it, driven by Capable's search index. Only Image reference macro usage is counted.Edit an image before insertingSelecting 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 editeInsert position controlInserting from the byline shows a heading picker so you can choose where on the page the image lands. Inserting from the 'Image (Capable)' macro placeholder does not. It replaces the macro node where it already sits.Two insert modes'Insert N references' places Image reference macros (live links). 'Insert N images' places native Confluence image nodes (frozen copies that render in exports and for logged-out readers). The references button is disabled whenever any non-lCopy as macroAn image or folder context-menu action that copies a Capable asset URL. Pasting an image URL into a page auto-converts into the Image reference macro; pasting a folder URL auto-converts into the Image folder gallery macro.Set an image as a page coverWrites the Confluence cover-picture properties for both the published and draft page at position 50. Refused unless the caller has update permission on the page.Library images are real Confluence contentEach library image is a Confluence custom-content record of type 'Capable Image Content'. Indexed, storage-bodied, duplicate-title-protected, and able to live under a space, page or blogpost with attachments and comments as children. It is
#Related
How it actually behaves.
