Widget Not Showing

If your Boei widget is not appearing on your website, work through this checklist.

How to get there: Confirm the install on your live site, then verify settings at Setup → Widget.

1. Confirm the Install Code Is Present

Open your site in a browser, right-click → View Page Source, and search for boei.help. You should see a script tag pointing to Boei's CDN.

If the script is missing, re-install using the install snippet or your platform's guide (WordPress, Shopify, etc.).

2. Check last_loaded_at

Go to Setup → Widget → click your widget. The widget settings page shows when the widget was last loaded by a real browser. If it shows "Never" or a very old date, the widget code is not running on your site.

3. Test in a Private Window

Browser extensions (ad blockers, privacy tools) can block the widget. Open your site in a private/incognito window with all extensions disabled. If it appears there, an extension is the cause and only that user is affected.

4. Check Page Conditions

If you set page conditions (show only on /contact, hide on /admin, etc.), make sure the current page matches. Go to Setup → Widget → click your widget → Display tab → review the conditions.

5. Check Country Targeting

Widgets can be restricted to specific countries. Verify you are testing from an allowed country, or temporarily remove the country filter.

6. Check Business Hours

If you enabled business hours and chose Hide widget outside hours, the widget will not appear when your team is offline. See Business Hours.

7. Check Browser Console for Errors

Open developer tools → Console tab. Look for errors mentioning boei. Common errors:

  • widget id not found — wrong widget UUID in install snippet
  • CORS errors — your domain is not registered in Boei
  • 404 — script URL is wrong

8. Cache Issues

If you recently changed widget settings, your browser may be caching the old version. Hard refresh (Cmd+Shift+R or Ctrl+Shift+R). Widgets are cached for 1 hour on Boei's side as well.

Still Stuck?

Contact support with:

  • Your widget UUID
  • The URL where you expect the widget to appear
  • A screenshot of the install code on your page