Troubleshooting: the Webchat widget doesn't appear on your site

Installed the Webchat snippet but the chat bubble won't show up? Work through the most common causes: wrong snippet placement, HTTPS, CSP and browser console errors.

Jun 26, 2026

Watch this step in the video · Troubleshooting

The Webchat widget is the chat bubble you embed on your website. When you paste the snippet and the bubble doesn't show, it's almost always one of five things. This guide walks them in order, from the most common to the most obscure.

Before you start

  • You need a Webchat channel already created in Channels -> Connect channel -> Webchat.
  • Open the page where the bubble should appear in an incognito window (to rule out cache and extensions).
  • Keep the browser console handy: in Chrome/Edge press F12 and open the Console tab.

Diagnostic steps

  1. Make sure the snippet is complete and in the right place. On the Webchat channel open the Install (embed) tab and copy the code again. It should look like this and be pasted right before the closing </body> tag:

    <script src="https://omnifox.io/widget/loader.js" data-widget-key="..." async></script>
    

    A classic mistake is pasting it inside a comment, inside another <script>, or after </body>.

  2. Confirm your site uses HTTPS. loader.js is served over HTTPS and browsers block mixed content: if your page loads over http://, the script won't run. Move your site to HTTPS.

  3. Check the browser console. Reload with the console open and look for red lines. Useful signals:

    • Failed to load resource ... loader.js -> the page can't reach Omnifox (firewall, blocker, or the snippet points to the wrong URL).
    • CSP errors (Content-Security-Policy ... refused to load) -> your CSP header is blocking omnifox.io. Add https://omnifox.io to script-src and connect-src.
    • Ad/privacy blockers can stop the widget; test with them disabled.
  4. Check the data-widget-key. If you hand-edited it and it ended up truncated, the loader can't find the channel. Re-copy the whole snippet from the Install tab and don't alter that string.

  5. Rule out cache. If you use Cloudflare, a caching plugin, or a CDN, purge the site cache and retest in incognito.

How to verify it works

The channel's Install tab has an "Installed on" log listing the domains where the loader has fetched. The first time someone opens a page with your snippet, the host domain shows up there. If you see your domain with a recent timestamp, the install is good. If it says "No installations detected yet", the snippet hasn't run in any browser yet.

If it still doesn't work

  • Try another browser and your phone: if it shows in one but not another, it's an extension or local cache.
  • If you use a site builder (Wix, Squarespace) or an <iframe>, confirm it allows inserting custom scripts into the body.
  • Make sure the Webchat channel is active and not paused under Channels.

Tips

  • Keep the snippet in your global template (theme footer) so it loads on every page, not just one.
  • After changing the widget's color, name or greeting you don't need to reinstall: the loader reads the config live.

Related articles

Was this helpful?

Related articles

Message us on WhatsApp