Troubleshooting 4 min read 5 steps Updated 24 April 2026

My embed is not showing on my website

If your Emberhop embed is not appearing on your website, the cause is almost always one of a small number of common issues. This guide walks you through how to diagnose and fix them.

My embed is not showing on my website

A blank space where your Emberhop embed should be is one of the most common issues people run into after setting up a document. In most cases the fix is straightforward. Follow these diagnostic steps in order to find the cause.

Five-step diagnostic

1
Verify the embed code is pasted correctly

Go back to the Emberhop dashboard and copy the embed code again from the "Embed" tab on your document. Compare it to what is on your page. Make sure the script tag is complete and that the document ID in the URL has not been truncated or altered. Even a single missing character in the ID will cause the embed to fail silently.

2
Check the browser console for errors

Open your browser's developer tools (F12 in most browsers, or right-click and choose "Inspect"). Go to the Console tab and reload the page. Look for any red error messages. A blocked script, a 404 error, or a network failure will appear here and tell you what went wrong.

3
Check for Content Security Policy blocks

If you see a "Refused to load" or "Content Security Policy" error in the console, your site's CSP is blocking the Emberhop script. You will need to add emberhop.com to your site's frame-src and script-src directives. See the separate article on CSP issues for the exact changes to make.

4
Check for HTTP vs HTTPS mismatch

The Emberhop embed script is served over HTTPS. If your website is still running on plain HTTP, modern browsers will block the script from loading as a "mixed content" security measure. The fix is to ensure your website runs on HTTPS. If you are on a managed hosting platform, enabling SSL is usually a one-click operation in your hosting control panel.

5
Disable ad blockers and test in incognito mode

Some ad-blocking browser extensions block embed scripts from third-party domains. Open your page in an incognito or private browsing window with extensions disabled. If the embed appears in that context but not in your normal browser window, an extension is interfering. Your visitors may not have the same extension installed, so this may not affect them even if it affects your own testing.

Check that the document is active

If none of the steps above reveal the issue, go to your Emberhop dashboard and check the status of the document. A document that is still processing, that has been archived, or that has been deleted will not render in the viewer. The dashboard shows the document status on the documents list. An active document shows a green indicator. If the status shows "Processing", wait a minute and reload the dashboard.

Good to know

If you are testing on a local development environment (like localhost), some CSP and mixed-content rules behave differently than on a live domain. Try testing on your actual published website URL before assuming the embed is broken.

Still not working?

If you have worked through all the steps above and the embed is still not appearing, contact the Emberhop support team. When you reach out, include the URL of the page with the embed, the document ID from your Emberhop dashboard, and a screenshot of any browser console errors. That information lets the support team diagnose the issue quickly.