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.
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.