Everything else
Start from what you are seeing rather than from what you think is broken. Each page below names the symptom, explains why it happens, and says what to do about it.
Several of these are the product working as designed, which is worth knowing before anybody raises a ticket.
#At a glance
Symptom | Usually because |
|---|---|
Page that uses an image is not listed under 'Used on Pages' | Three possible reasons. The index has not caught up yet; the page is beyond the 25-page cap; or the reference was created by pasting a link that was never re-saved, so it carries no stored i |
Page shows 'This image could not be found' where an image used to be | The library image the macro points at has been deleted. |
Image shows 'Sign in to view this image' to logged-out visitors, even though the image exists | The image is stored as a plain external URL. That is the only source type that needs Capable's token-carrying proxy, and a logged-out reader has no token. Uploaded library files, Unsplash im |
Image shows 'This image could not be loaded. Try again shortly.' | A transient server error or rate limit while fetching the image. |
Style settings on my gallery do nothing | You are using Table layout. Corner radius, Gap, Shadow, Border and Thumbnail Height are applied only to the Grid renderer; table rows use a fixed 56 px preview and fixed styling. Only Image |
Gallery I created by pasting a folder link looks different from one I inserted from the macro browse | Inserting from the macro browser applies the nicer insert defaults (corner radius 8, gap 16, small shadow) plus any tenant brand guidelines. |
Gallery says 'No images in this folder' but the folder definitely has images | The reader most likely cannot see the folder's space. Confluence filters search results by permission and returns an empty result rather than refusing the query, so a permission problem look |
Width or Height is set to 500 but the image sizes itself automatically | 500 was a legacy sentinel meaning 'auto-size', so a macro saved with 500 behaves as if the field were blank. |
Can drag an SVG into the library but the Upload button will not let me choose one | The Upload button's file dialog filter and the drag-and-drop accepted list are different. Drag-and-drop accepts svg, ico and jfif; the Upload dialog does not offer them. |
'Invalid file type — Only image files are allowed' when dragging a file in | The file's extension is not on the drag-and-drop accepted list (bmp, gif, ico, jfif, jpeg, jpg, png, svg, tiff, webp, psd, ai, pdf). |
Global images section has disappeared from the library | The CAPABLEASSETSTORE space is missing, unreadable by this user, or could not be created. A failed creation is remembered for the rest of the session and not retried. |
Deleted a folder and the images that were in it are unaccounted for | Deleting a folder issues a single delete for the folder record itself. There is no cascade, no orphan sweep and no confirmation listing what is affected. |
'Image (Capable)' macro sits on a page showing 'No Images Selected' | Somebody inserted the placeholder macro and cancelled the picker. The card stays on the page and is visible to readers, not just the author, and the picker will not reopen automatically for |
Capable macro (Banner, Cards, Gallery, Compare, Background) stopped showing its image after I update | The shared image picker stores a direct URL, not a live reference. Those macros never follow later library edits, and if the library image is deleted they are left pointing at a dead URL wit |
#In this section
#Related
Most of these are expected behaviour.
