Liqaa Widget Not Showing on Website

Quick Checklist

Run through these checks in order:

Domain verified? — Go to Settings > Domains and ensure your domain shows a green checkmark
Correct widget key? — Compare data-widget-key in your code with the key in Settings > Widget
Script placed correctly? — Must be before </body>, not inside <head>
HTTPS enabled? — The widget only loads on secure (HTTPS) pages

Common Issues

Ad Blockers

Some ad blockers and privacy extensions block third-party scripts:

Test in an incognito/private window with extensions disabled
Ask visitors to whitelist your domain or the api.liqaa.id domain
Consider using a custom domain for the widget script (Business plan)

Content Security Policy (CSP) Headers

If your site uses strict CSP headers, you need to allow the widget:

Content-Security-Policy:
  script-src 'self' https://api.liqaa.id;
  connect-src 'self' https://api.liqaa.id wss://api.liqaa.id;
  frame-src 'self' https://api.liqaa.id;

JavaScript Errors

Open browser DevTools (F12 or Cmd+Option+I)
Go to the Console tab
Look for errors mentioning liqaa, widget, or script
Common errors:

- Failed to load resource — Network issue or blocked script

- widget-key not found — Invalid or expired widget key

- CORS error — Domain not verified

Wrong Widget Key

Go to Messenger > Settings > Widget
Click Copy Widget Code to get a fresh embed snippet
Replace the old code on your website

Debug Steps

Open your website in Chrome
Open DevTools > Network tab
Filter by liqaa or widget
Refresh the page
Check if widget.js loads with status 200
If not loading, check for blocked requests (red entries)

Still Not Working?

Contact support with:

Your website URL
Screenshot of browser console
Screenshot of Network tab filtered by "liqaa"
Your browser name and version