Zendesk Web Widget Not Showing: Causes and Fixes

This guide walks the failures in order of how often they actually happen, so you can stop at the first one that matches instead of reading to the end. Every step is verified against Zendesk's current documentation (June 2026); Zendesk revises its UI periodically, so confirm labels in your own account.

The symptom

"The widget isn't showing" usually means one of three slightly different things — and it's worth being precise, because they point to different causes:

• Nothing at all on the page (no bubble, no launcher). Most often an install/placement problem or a blocked script.
• The bubble appears but won't open, or opens to an error. Usually a JS conflict, a CSP/connection block, or a half-loaded snippet.
• It shows for you but not for customers (or only on some pages). Caching, consent gating, or the snippet only living on certain pages.

Keep which one you're seeing in mind — it'll help you skip straight to the likely fix below.

Quick triage (do this first, ~3 minutes)

Before changing any settings, run these four checks. They tell you where the problem is — your page, the network, or Zendesk's config — which saves you from blindly toggling things.

1. View source / inspect the page. Right-click → View Page Source (or open DevTools → Network and filter for zdassets). Search the HTML for static.zdassets.com or snippet.js. If the snippet isn't there, the problem is installation, not Zendesk. If it is there, move on.
2. Open the browser console (F12 → Console). Look for red errors mentioning zdassets, zendesk, smooch, CSP, ERR_INSECURE_RESPONSE, or "blocked." These are signposts to the exact cause.
3. Try an incognito window with extensions off. If the widget appears in incognito but not normally, an ad-blocker or privacy extension is the culprit (see cause 5).
4. Try another device or network. If it shows on your phone but not your office laptop, suspect a corporate firewall, network filter, or cached page.

Now work the ranked list below, starting at the top.

Causes and fixes, ranked by likelihood

1. The snippet isn't installed, or it's in the wrong place

This is the number-one cause, by a wide margin. The widget only renders where its code snippet physically exists in the page HTML.

Confirm it: In View Page Source, search for the snippet. For the modern messaging widget you're looking for a script referencing static.zdassets.com/.../snippet.js?key=.... Not there? It's not installed on that page.

Fix it: Get the code from the right place — in Admin Center → Channels → Messaging and social → Messaging, click the name of your widget, scroll down, expand Installation, and click the copy icon (Zendesk: Installing the Web Widget for messaging). Then paste it immediately before the closing </body> tag on every page where you want the widget to appear. Two sub-traps live here:

• Wrong location. Zendesk specifies before </body>. Pasting it in a spot a template strips, or after </body>, can stop it rendering.
• Only on some pages. A common variant: the snippet is in your Help Center (which Zendesk can install in one click) but not on your marketing site or app pages, which need the code added manually. Pages outside the Help Center won't inherit it (Zendesk on widgets outside the Help Center).

For a full walk-through of getting and placing the code, see our guide to adding the Zendesk Web Widget.

2. Messaging isn't turned on, the widget isn't published, or it's not tied to the brand

If the snippet is on the page but nothing loads, the channel itself may be inactive on Zendesk's side.

Confirm it: In Admin Center → Channels → Messaging and social → Messaging, check that messaging is on and that the specific widget exists and is enabled. For multi-brand accounts, verify the widget is assigned to the brand whose pages you're testing — a widget bound to Brand A simply won't appear on Brand B's site.

Fix it: Turn messaging on, confirm the widget is active, and assign it to the correct brand. If you've never enabled messaging at all, start with our step-by-step messaging setup guide — the snippet you copied is generated by that channel, so the order matters.

3. It's set to show only during business hours or only when agents are online

A widget that "disappears" at 6pm or on weekends isn't broken — it's behaving as configured. This bites Classic Web Widget / Chat setups especially.

Confirm it: Check whether operating hours (for Chat / Classic) are enabled. With operating hours on, the widget is only online during those hours, and an agent who logs in outside them is Invisible by default (Zendesk: creating a schedule with operating hours). Classic Web Widget will also show nothing if no agent is online and you haven't configured a contact form or offline form (Zendesk troubleshooting guide).

Fix it: Either test during business hours with an agent online, or change the behavior. For messaging, set up a business-hours schedule with an out-of-hours response so the widget stays visible and sets expectations instead of vanishing (Zendesk: configuring messaging responses and business hours). For Classic, add a contact/offline form so there's always something to show.

4. Caching or a CDN is serving an old page

You added the snippet, but the page your browser (or visitors') loads is a cached copy from before you added it.

Confirm it: The widget shows in a fresh incognito window but not your normal one, or it shows for you but not customers. View source on the live URL — if the snippet is missing there but present in your CMS editor, you're being served a stale page.

Fix it: Purge the cache at every layer that has one — your CDN (Cloudflare, Fastly, Akamai), your CMS or page cache (WordPress cache plugins are frequent offenders), and your browser (hard-refresh with Cmd/Ctrl+Shift+R). Re-test in incognito to confirm.

5. An ad-blocker, privacy setting, or strict CSP is blocking the widget

The widget loads assets from static.zdassets.com and connects to Zendesk and Smooch/Sunshine domains. Anything that blocks those stops it cold.

Confirm it: The console shows entries like blocked by client, a CSP violation, or refused connections to .zdassets.com, .zendesk.com, or *.smooch.io. The incognito test from triage is the fast signal for browser extensions; Firefox's Enhanced Tracking Protection can block it too (Zendesk troubleshooting guide).

Fix it: You can't control visitors' ad-blockers, but you can fix your own Content Security Policy, which is a self-inflicted version of the same block. Per Zendesk's CSP support doc, allowlist the widget's hosts — including https://.zdassets.com, https://.zendesk.com, https://.smooch.io, and wss://.zendesk.com — and, if you follow Google's strict-CSP guidance, add the nonce attribute to the widget snippet. Also confirm a corporate firewall isn't blocking those domains on your network.

6. The snippet key is wrong, or the widget was deleted/disabled

A snippet from a deleted, disabled, or different widget will silently do nothing.

Confirm it: Compare the key= value in your page's snippet against the current code in Admin Center → your widget → Installation. If they don't match — or the widget no longer exists in Admin Center — that's your answer.

Fix it: Recopy the current snippet and replace the old one everywhere it's installed. Watch for stale copies hard-coded into a theme, a tag manager container, or a cached layout from an old install.

7. A JavaScript error or conflicting script is breaking the page

If another script throws an error before the Zendesk snippet runs, the widget may never initialize.

Confirm it: The console shows an unrelated red error high up, or errors that reference your own bundle, jQuery, or another third-party tool — and the Zendesk script appears in the Network tab but never executes. Conflicts with other chat widgets or older Zendesk embeds are common.

Fix it: Resolve the upstream JS error, and make sure you're not loading two chat widgets (e.g. Classic and messaging, or a competitor tool) that fight over the same launcher. Remove the duplicate, then re-test.

8. Classic Web Widget vs. messaging Web Widget mismatch

Zendesk has two different widgets: the legacy Web Widget (Classic) under Channels → Classic, and the modern messaging Web Widget under Channels → Messaging and social. They use different snippets and different admin pages.

Confirm it: Decide which one you actually want, then check you're configuring and installing that same one. A frequent failure: someone enables messaging but the site still has the Classic snippet (or vice versa), so the thing they configured never appears.

Fix it: Pick one widget, copy its snippet from its admin location, and remove the other's code from the page. For new setups, messaging is the modern path — see how to set up Zendesk messaging.

9. A consent manager (GTM / cookie banner) is blocking it until consent

If you load the widget through Google Tag Manager or behind a consent/cookie manager, it may be suppressed until the visitor accepts cookies — so it correctly "doesn't show" for anyone who hasn't consented (or for you, mid-test).

Confirm it: The snippet exists in your GTM container or is wrapped in a consent gate, and the widget appears only after you accept the cookie banner. Check whether the tag is set to fire only on a consent trigger.

Fix it: Decide intentionally. Either accept consent to verify it works, classify the widget under the right consent category so it fires when appropriate, or install the snippet directly in the page rather than via a consent-gated tag if your policy allows. Also note: loading via GTM adds a dependency — if GTM itself is blocked or misconfigured, the widget goes with it.

Verification: confirm it's actually fixed

Don't trust a single reload. Verify properly:

1. Hard-refresh in incognito on the exact live URL (not your editor preview). The launcher should appear within a second or two.
2. Open it and send a test message. Confirm the panel opens and the message reaches your Agent Workspace as a conversation/ticket.
3. Check a second page and a second device — ideally one outside your office network — to rule out caching and local blocking.
4. Re-open the console and confirm there are no remaining zdassets/CSP/connection errors.

If isolating the problem is hard, paste your snippet alone into a blank test page (jsfiddle.net or a stripped HTML file). If the widget appears there but not on your real site, the problem is interference or placement on your site — not the widget itself (Zendesk troubleshooting guide).

Diagnostic checklist

Run top to bottom; stop at the first failure.

• [ ] Snippet present? View source → search static.zdassets.com / snippet.js. Missing → reinstall (cause 1).
• [ ] Placed before </body> on this page? Wrong spot or only on some pages → fix placement (cause 1).
• [ ] Messaging on, widget active, assigned to the right brand? (cause 2)
• [ ] Business/operating hours or agent-online gating? Test during hours with an agent online (cause 3).
• [ ] Stale cache? Hard-refresh + purge CDN/CMS; re-test in incognito (cause 4).
• [ ] Console errors? CSP / ERR_INSECURE_RESPONSE / blocked → fix CSP, SSL, firewall (cause 5).
• [ ] Incognito with extensions off? Works there only → ad-blocker/privacy (cause 5).
• [ ] Snippet key= matches current Admin Center code? (cause 6)
• [ ] Any unrelated JS errors or a second chat widget? (cause 7)
• [ ] Configuring the same widget you installed (Classic vs messaging)? (cause 8)
• [ ] Loaded via GTM/consent — does it fire pre-consent? (cause 9)
• [ ] Another device/network confirms it's not local.

Prevention: stop it recurring

• Install once, centrally. Put the snippet in a shared layout/template (or one well-managed GTM tag) so every page inherits it — instead of pasting per-page and forgetting some.
• Allowlist Zendesk's domains in your CSP from day one, including .zdassets.com and .zendesk.com, so a future security tightening doesn't silently kill the widget.
• Document which widget you use (Classic vs messaging) and its key, so a teammate doesn't install the wrong one later.
• Add a post-deploy smoke test: after any site release or CSP/cache change, load the homepage in incognito and confirm the bubble appears. Deploys are when widgets quietly disappear.
• Set an out-of-hours response instead of hiding the widget after hours, so "it's gone at night" never becomes a support ticket.

Where AI fits in once the widget works

Getting the widget back on the page is step one — but a visible widget is just an open door; someone (or something) still has to answer what walks through it. Once your Zendesk messaging widget is loading reliably, an AI agent can handle the conversations it brings in.

That's the layer Macha adds. Macha isn't a help desk and it isn't a Zendesk replacement — it runs on top of your existing Zendesk messaging channel. When a customer opens that now-working widget, Macha reads the actual question, pulls from your connected knowledge base and past tickets, and resolves it inside the same thread — escalating to a human agent, with full context, whenever it isn't confident. The honest caveats: it's one more integration to configure, and it's only as good as the knowledge you connect. On cost, Macha bills per AI action — each automated step it takes, like drafting a reply, tagging, or routing — not per closed conversation, because most automation is work done along the way rather than a tidy "resolution." If your widget traffic is mostly repeat questions your help center could answer, that's the line worth exploring. You can try it free — 7-day free trial, no credit card required.

Frequently asked questions

Why is my Zendesk widget not showing on my website? Most often the code snippet isn't installed on that page, or it's in the wrong place — it must sit immediately before the closing </body> tag on every page where you want it. Other frequent causes: messaging isn't turned on or the widget isn't assigned to that brand, operating/business hours are hiding it, a stale cache is serving an old page, or a CSP / ad-blocker / firewall is blocking static.zdassets.com. View your page source first to confirm whether the snippet is even there.

The Zendesk chat widget isn't showing but the snippet is on the page — why? The script is present but blocked or misconfigured. Open the browser console: a CSP violation or refused connection to .zdassets.com / .zendesk.com points to a Content Security Policy or firewall block; an ERR_INSECURE_RESPONSE points to a missing SSL certificate. Also check that the widget is active in Admin Center, assigned to the right brand, and that no operating-hours rule is hiding it.

My Zendesk web widget is not appearing only on some pages. What's wrong? The snippet likely isn't on those specific pages. Zendesk can one-click install it on your Help Center, but pages outside it — your marketing site, app, landing pages — need the code added manually. Put it in a shared layout/template so every page inherits it, and purge any cache that might be serving older versions of those pages.

Why does my Zendesk widget disappear after business hours? That's expected behavior if operating hours (Chat) are enabled or no agent is online with no contact/offline form configured. For messaging, set up a business-hours schedule with an out-of-hours response so the widget stays visible and tells customers when you'll reply, instead of vanishing.

Why isn't my Zendesk widget loading after I switched to messaging? Likely a Classic-vs-messaging mismatch. The legacy Web Widget (Classic) and the messaging Web Widget are different channels with different snippets and admin pages. If you enabled messaging but your site still has the Classic snippet (or vice versa), the widget you configured won't appear. Copy the messaging snippet from Admin Center → Channels → Messaging and social → Messaging → your widget → Installation, and remove the old Classic code.

Could an ad-blocker stop the Zendesk widget from showing? Yes. Ad-blockers and strict privacy settings (including Firefox Enhanced Tracking Protection) can block the widget's scripts. You can't control visitors' extensions, but test in an incognito window with extensions off to confirm — and make sure your own Content Security Policy and firewall allowlist Zendesk's domains so you're not blocking it yourself.

The bottom line

When the Zendesk widget is not showing, resist the urge to randomly toggle settings. Run the triage — view source for the snippet, check the console, test in incognito and on another device — then work the ranked list. In practice it's almost always one of three things: the snippet isn't on the page (or not before </body>, or missing on some pages), the channel isn't on / not assigned to the right brand, or something is blocking the script (cache, CSP, ad-blocker, or a Classic-vs-messaging mismatch). Fix the cause, verify in incognito on the live URL, and add a post-deploy smoke test so it doesn't quietly break again. Once the widget reliably loads, the next question is who answers the conversations it brings in — and that's a problem worth solving on purpose.

Causes and fixes verified against Zendesk's official documentation, June 2026. Zendesk updates its product periodically — confirm labels and settings in your own account before relying on them.