An image or feed will not load

If a macro shows a placeholder where an image, an RSS feed or an embedded page should be, the most likely cause is a domain that hasn't been approved.

A macro that fetches something from outside Confluence can only reach domains an administrator has approved. Without that approval, the reader's browser isn't allowed to make the request, so the macro shows a placeholder instead.


#What to check

Check

Detail

Is the domain approved?

Approved domains are configured in the Atlassian Admin Hub, not in the app

Is the reader signed in?

RSS feeds show a sign-in notice to anonymous readers rather than the feed

Is the source reachable?

A URL that needs a sign-in will not load for anybody

Is it an attachment instead?

Page attachments need no approval and are the safest source

The quickest fix is usually to upload the file to the page as an attachment. If it has to come from a URL, ask your administrator to approve the domain.

Embed macro with a YouTube URL entered and a green note under the URL field saying the domain is approved for embedding
When a domain is approved, the Embed macro says so under the URL field on the right.

#A few things worth knowing

  • Attachments are the safest image source and survive publishing to a site cleanly.

  • An approved domain applies site-wide, not per space.

  • Anonymous readers see less than you do, so test while signed out.



Attachments always work. URLs need approving.