Image does not appear in a rendered document

What you are seeing

An image does not appear in a rendered document, or shows '[Image failed to load: ...]' instead.


#Why it happens

In Jira, web images load through Capable's image proxy. An image does not show when:

  • its address is relative, such as ./diagram.png, which cannot be resolved in Jira;

  • its address is broken, private or needs a login the proxy does not have;

  • it skips the proxy, as images on images.unsplash.com do, and is then blocked inside Jira;

  • it is written as an HTML <img> tag, which is not rendered.


#What to do

Use Markdown image syntax with a full, public address on an ordinary image host, and avoid images.unsplash.com links. Signed-in viewers see the image; logged-out viewers see nothing from the app.


#Limits that apply here

Limit

Value

What happens

Simultaneous image loads

20

At most 20 image URLs are resolved at once, so image-heavy documents load in waves.

Image load timeout

15 seconds

An image that has not loaded by then shows '[Image load timed out: ...]'.

Raw HTML in Markdown

Not rendered

The viewer strips HTML, so <img> tags do not render. Use Markdown image syntax.



Found it? Good.