Zurvo
Security & Troubleshooting

Fix a widget that isn't showing on your site.

The chat widget won't appear? Check the install snippet and ID, script blockers, page caching, and builder limits — with the iframe fallback for tricky sites.

The Zurvo install page showing the script-tag snippet with the data-zurvo-id attribute and the iframe alternative.

If you’ve installed the widget but it isn’t appearing on your site, it’s usually a small install issue. Grab your exact snippet from the install page first, then work through these checks.

Your install page shows a live install status — whether Zurvo has seen your widget load on your site yet, and on which domain. That status is the fastest way to tell whether the problem is your install or something else.

1. Check the snippet and your chatbot ID

The recommended install is a single script tag that Zurvo generates for you, already filled in with your chatbot’s ID:

<!-- Zurvo Chat Widget -->
<script
  src="https://app.zurvo.ai/widget.js"
  data-zurvo-id="YOUR_CHATBOT_ID"
  async
></script>

The most common mistake is a wrong or missing data-zurvo-id. That attribute tells the widget which chatbot to load — if it’s blank, mistyped, or points at a different chatbot, the widget won’t show. Copy the snippet directly from your install page rather than typing it by hand, so the ID is exactly right.

Also confirm the snippet is placed just before the closing </body> tag on every page where you want the widget, and that it wasn’t accidentally split or reformatted when you pasted it.

2. A script blocker or CSP is stopping it

If the snippet is correct but the widget still doesn’t load, something on the page may be blocking the script — a browser ad/tracker blocker, a privacy extension, or a strict Content Security Policy on your site. Test in a private/incognito window with extensions off to rule out browser blockers.

If your site’s security policy blocks third-party scripts, use the iframe embed instead. Zurvo gives you an iframe snippet on the install page that renders the widget without running any script on your page:

<iframe
  src="https://app.zurvo.ai/widget/YOUR_CHATBOT_ID"
  style="position: fixed; bottom: 0; right: 0; width: 400px; height: 550px; border: none; z-index: 9999;"
></iframe>

3. Your builder can’t run custom scripts

Some website builders don’t allow custom <script> tags on lower-tier plans — GoDaddy’s Website Builder is a common example. On those platforms the script snippet silently does nothing because it’s never allowed to run.

The fix is the same iframe embed above: it works without script permissions. See Installing on your site for the per-platform steps.

4. Caching is serving an old page

If you added the snippet but your site still serves a cached version of the page, the widget won’t appear until the cache clears. Clear your site’s cache (and any CDN or caching-plugin cache), then hard-refresh the page in your browser. This is a frequent cause on WordPress sites running a caching plugin.

5. Verify the install for your platform

Each platform has a slightly different place to paste the snippet. Follow the exact steps for yours — WordPress, Wix, Squarespace, Shopify, Webflow, or GoDaddy — in Installing on your site. After you save and publish, reload your site and check the install status back on the install page; once Zurvo has seen the widget load, the status updates to installed.

Still not showing?

If you’ve confirmed the snippet, ID, and placement, cleared your cache, and tried the iframe method, check the Troubleshooting FAQ or reach out and we’ll help you verify the install.

Frequently asked questions.

Where do I put the widget code?

Paste the script snippet just before the closing </body> tag on every page you want the widget to appear on. Zurvo gives you the exact code, pre-filled with your chatbot's ID, on the install page.

My site builder won't let me add a script — what do I do?

Some builders (like certain GoDaddy plans) don't allow custom scripts. Use the iframe embed method instead — Zurvo provides an iframe snippet on the install page that works without running any script on your site.

Still need help?

Reach out and we'll help you get set up — or start your free trial and see Zurvo on your own site.