# Image does not appear in a rendered document

**What you are seeing**

An image does not appear in a rendered document.

---

## Why it happens

Images normally load through Capable's proxy. Anything that bypasses the proxy. Including images.unsplash.com, images already on an admin-approved domain, or a broken URL. Is blocked by the app's image policy with no visible message. Relative image paths also cannot be resolved, because the Jira surfaces pass no base URL.

---

## What to do

Use a full absolute URL to an ordinary image host and avoid relative paths. Avoid images.unsplash.com. If nothing shows, check the browser console for a blocked request.

---

## Settings involved

| **Setting**               | **Where**    | **What it does** |
| ------------------------- | ------------ | ---------------- |
| View / Edit (editor mode) | Editor modal | \-               |

---

## 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.                                                                              |
| Session token lifetime   | 20 minutes   | The short-lived token that authorises diagram rendering and image proxying lasts 20 minutes and is refreshed after 18 minutes, on window focus and on reconnect. |
| Raw HTML in Markdown     | Not rendered | The viewer strips HTML and sanitises output, so HTML tags embedded in a Markdown document do not render.                                                         |

---

## Related

[Sort tabs button is missingThe button is hidden when the panel is narrow.](https://help.gocapable.com/jira-markdown/sort-tabs-button-is-missing.html)

[Install prompt lists permissions the app does not appear to use, such as webhook or project managemeThe app requests manage:jira-webhook, manage:jira-project and manage:jira-configuration at](https://help.gocapable.com/jira-markdown/install-prompt-lists-permissions-the-app-does-not-appear-to-use-such-as-webhook-or-project-manageme.html)

[Something is missing or looks wrongThe rest of this family.](https://help.gocapable.com/jira-markdown/something-is-missing-or-looks-wrong.html)

---

_Found it? Good._