> For the complete documentation index, see [llms.txt](https://docs.supademo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.supademo.com/troubleshooting/embed-not-loading.md).

# Embedded Demo Not Loading

Fix a Supademo embed that shows a blank frame: check for host platforms that strip iframes, ad blockers, CSP frame-src rules, and demo share permissions.

You've pasted a Supademo embed into a website, doc, or knowledge base, but where the demo should appear there's a blank space, a broken frame, or nothing at all. Supademo embeds are iframes served from `app.supademo.com` (or your custom white-label domain), so when an embed doesn't load, the cause is almost always something between the viewer and that iframe — the host platform, a browser extension, or the demo's own share settings.

Work through the causes below in order; the first two account for most cases.

## Common causes and fixes

1. **The platform strips iframes.** Email clients don't render iframes at all, and some website builders and CMS platforms remove custom embeds on restricted or free plans. Fix: for email, use a linked GIF or thumbnail that points to the demo's share link — you can [export your Supademo as a GIF or MP4](/share/exports.md). For CMS platforms, check whether your plan allows custom embeds, and see [embed instructions for popular apps](https://docs.supademo.com/share/embed/instructions-for-popular-apps) for the platform-specific method.
2. **The embed code was pasted as plain text.** Rich-text editors often escape pasted HTML instead of rendering it. Fix: use the platform's dedicated embed or HTML block (Notion, Confluence, GitBook, and Framer all have one), or paste just the demo URL where the platform supports link unfurling. Re-copy the embed code fresh from your demo's share options to rule out a mangled snippet.
3. **An ad blocker or privacy extension is blocking the iframe.** Blockers sometimes treat third-party iframes as trackers. Fix: reload the page in an incognito window with extensions disabled. If the embed appears, the extension is the culprit — allowlist `app.supademo.com` (or your custom domain).
4. **Your site's Content-Security-Policy blocks the frame.** If your site sets a `frame-src` (or `child-src`) CSP directive, browsers will refuse to load iframes from unlisted domains. Fix: add `app.supademo.com` — or your white-label domain — to the directive. Note that `frame-ancestors` and `X-Frame-Options` on your site do **not** affect Supademo embeds; those headers only control who may frame *your* pages.
5. **A corporate network is blocking the demo domain.** Firewalls and content filters sometimes block unrecognized domains inside iframes. Fix: ask IT to allowlist `app.supademo.com` or your custom demo domain; confirm by opening the demo's direct share link on the same network.
6. **The demo itself isn't accessible.** A demo that's unpublished, archived, restricted by [share permissions](https://docs.supademo.com/share/share-link/share-permissions), gated behind a password, or shared through an expired link will not render for viewers. Fix: open the direct share link in an incognito window. If it doesn't load there either, the problem is access, not the embed — publish the demo or loosen its restrictions.

## Still not working?

Email [**support@supademo.com**](mailto:support@supademo.com) with the demo's share link, the URL of the page where it's embedded, and your browser. Screenshots of any errors in the browser console speed things up. For general questions about embedding, see the [Embed guide](/share/embed.md) or the [FAQs](https://docs.supademo.com/welcome/faqs).