Troubleshooting: Quidget Web Chat doesn’t appear on your website

If you’ve added the Quidget Web Chat snippet but the widget doesn’t show up (or doesn’t work correctly), this guide walks you through the most common causes and fixes.

Quidget Web Chat V2 runs in an isolated iframe and is controlled by a small loader script.

Quick install checklist

Make sure all of the following are true:

• ✅ You pasted the full snippet right before the closing </body> tag.
• ✅ The snippet exactly matches the code from the Test & Install page.
• ✅ You don’t have a strict Content Security Policy (CSP) that blocks the widget.
• ✅ You don’t have lazy-loading enabled for iframes or scripts that affects the Quidget Web Chat.
• ✅ You don’t have global CSS rules that affect the widget button or the iframe element.

CSP / security policy blocks Quidget

Symptoms

Console errors like:

• “Refused to load the script … because it violates the Content Security Policy”
• “Refused to frame … because it violates the following Content Security Policy directive…”

Fix

Add (or merge) the following directives into your site’s Content-Security-Policy to allow Quidget Web Chat resources:

{
  description: 'Quidget AI Widget',
  entries: [
    {
      directive: 'connect-src',
      values: [
        'https://quidget.ai',
        'wss://api.quidget.ai',
        'https://us.i.posthog.com',
        'https://sentry.supportyourapp.com',
      ],
    },
    {
      directive: 'img-src',
      values: [
        'https://cdn.quidget.ai',
      ],
    },
    {
      directive: 'frame-src',
      values: [
        'https://quidget.ai',
        'https://*.quidget.ai',
      ],
    },
  ],
}

Referrer policy (required to pass referrer to the iframe)

To ensure the iframe receives referrer information (minimum required), set:

Referrer-Policy: strict-origin-when-cross-origin

Still having issues?

If your web chat still doesn’t work after applying the steps above, you may be running into a site-specific or infrastructure-level issue.

Please contact Quidget Support at 📧 support@quidget.ai