Troubleshooting widget installation

The icon isn't appearing

1. Open the browser console. If you see a 4xx error fetching loader.js, your data-key is wrong — copy it again from Installation.
2. Check for Content-Security-Policy errors. If your site has a strict CSP, you may need to allowlist cdn.hellocivic.com in your script-src and style-src directives.
3. Confirm the script tag is rendered server-side. View source (not DevTools — actual View Source) and search for hellocivic. If it's missing, your CMS or framework stripped it.

The icon appears but the panel won't open

Usually a CSS conflict — your site's CSS has a z-index higher than ours. Open DevTools, inspect the widget container, and bump our z-index via custom CSS in Appearance.

Features aren't working

Check that you've Published (not just saved a draft). The CDN cache is ~30 seconds — if you just published, give it a minute and hard-refresh.

Still stuck?

Submit a support ticket with your site URL and a screenshot of the browser console. We'll usually identify the problem in one round-trip.