Skip to main content

Troubleshooting Installation Issues

Most installation issues occur due to incorrect widget keys, caching problems, blocked scripts, or incomplete source setup.

How to Read the Browser Console​

  1. Open your site in the browser.
  2. Open developer tools with F12 or Ctrl + Shift + I.
  3. Go to the Console tab.
  4. Reload the page.
  5. Look for red errors related to the Witzo script, blocked network requests, or widget initialization.

Console errors are especially useful for CSP blocks, JavaScript conflicts, and invalid script loading.

Issue: Widget Not Showing​

Cause: Script not added correctly or cached version loading.

Solution:

  1. Confirm script is before </body>.
  2. Clear cache and CDN.
  3. Hard refresh browser.

Issue: Invalid Widget Key​

Cause: Incorrect or revoked widget key.

Solution:

  1. Go to Dashboard > Widget Customization.
  2. Copy the correct widget key.
  3. Replace it in your embed script.

Issue: Domain Allowlist Problem​

Cause: Your domain is not approved in widget configuration.

Solution:

  1. Verify the allowed domain matches the exact site domain.
  2. Check www vs non-www mismatch.

Issue: CSP Blocking Script​

Cause: Content Security Policy blocks external script loading.

Solution:

  1. Update CSP headers to allow the Witzo script domain.
  2. Check the browser console for CSP errors.

Issue: CDN Caching Old Script​

Cause: CDN is serving an outdated cached version.

Solution:

  1. Purge CDN cache fully.
  2. Test in incognito mode.

Issue: JavaScript Conflicts​

Cause: Another script throws a runtime error.

Solution:

  1. Open DevTools > Console.
  2. Fix conflicting script errors first.

Issue: Widget Loads but AI Does Not Answer​

Cause: The widget is visible, but the request is blocked by usage limits, missing training data, or a runtime/network problem.

Solution:

  1. Confirm the agent has completed training or retraining.
  2. Check Dashboard > Analytics for usage-limit exhaustion.
  3. Open the browser console and network panel for request failures.
  4. Verify the widget key and approved domain are correct.
  5. Retry with a simple test question after confirming the latest content source is indexed.
Support Note

If none of the above resolves the issue, contact Witzo Support and include your widget key, affected domain, and the error you saw in the browser console.