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:

Step	Action
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:

Step	Action
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:

Step	Action
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:

Step	Action
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:

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

---

Issue: JavaScript Conflicts

Cause: Another script throws runtime error.

Solution:

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