Skip to main content

Troubleshooting Installation Issues

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

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 in your embed script.

Issue: Domain Allowlist Problem​

Cause: Your domain is not approved in widget configuration.

Solution:

  1. Verify allowed domain matches 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 Witzo script domain.
  2. Check browser console for CSP errors.

Issue: CDN Caching Old Script​

Cause: CDN serving outdated cached version.

Solution:

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

Issue: JavaScript Conflicts​

Cause: Another script throws runtime error.

Solution:

  1. Open DevTools → Console.
  2. Fix conflicting script errors first.
Support Note

If none of the above resolves the issue, contact support and include your widget key and affected domain.