Troubleshooting

Troubleshooting: the widget isn't showing

The most common reasons the chat bubble doesn't appear, and how to fix each.


If the chat bubble isn't appearing on your site, work through these checks — one of them almost always explains it.

  1. 1Confirm the snippet is on the page — view source and search for widget.js. It should sit just before </body>.
  2. 2Check the Bot ID — data-bot-id must exactly match the bot you want to load.
  3. 3Clear your cache/CDN — if you use caching (Cloudflare, a caching plugin), purge it so the new code is served.
  4. 4Look for console errors — open your browser's developer console and check for any load errors.
  5. 5Rule out ad-blockers — some aggressive blockers hide chat widgets; test in a private window without extensions.

Still stuck? Email support@spideychat.com with your site URL and Bot ID and we'll help.