Something is missing or looks wrong
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 |
|---|---|
Image I just uploaded is missing from the library when I reload the page | The library catalogue, the search section and the Attached images sweep are all driven by Confluence's search index, which updates asynchronously. Only the folder listing hides the lag, by a |
'Used on Pages' is completely empty even though I know pages use the image | Indexing runs on page triggers that are filtered to licensed sites only, so an unlicensed or evaluation site indexes nothing at all. |
Gallery does not appear in a PDF or Word export | The Image folder gallery has none. |
Gallery does not appear on a published Capable Site | The Image folder gallery is on the published-site unsupported list. The folder listing and its download links have no equivalent outside Confluence. |
Referenced image is the wrong size on a published site | The site exporter reproduces alignment, caption, corner radius, shadow and border, but ignores Width, Height and Aspect Ratio. The published image falls back to the site's own image styling. |
Attachment I know exists is missing from the 'Attached images' view | That view is an index-driven sweep restricted to jpg, jpeg, png, gif, bmp, svg, webp, tiff and tif. AVIF, HEIC, ICO and JFIF attachments never appear. It also deliberately excludes the CAPAB |
#In this section
#Related
Most of these are expected behaviour.
