| Symptom | Likely Cause | Fix |
|---|---|---|
| Button does nothing | Script not loaded / blocked by CSP | Check browser console (F12) for errors. Add cdn.fitmyvehicle.com.au to script-src. |
| Blank/white iframe overlay | Iframe blocked by CSP | Add cdn.fitmyvehicle.com.au to frame-src in your CSP header. |
| ”Unable to Load Widget” error inside iframe | API domain blocked by firewall | Whitelist api.fitmyvehicle.com.au and cloud.fitmyvehicle.com.au. See Domains. |
| Widget loads but fonts look wrong | Font CDNs blocked | Whitelist use.typekit.net, p.typekit.net, fonts.googleapis.com, fonts.gstatic.com. |
| ”Origin not allowed” error | Your domain not registered in FMV | Contact FMV — your exact origin (e.g. https://shop.example.com) needs to be added to the FMV admin panel. |
| Quote submission fails silently | WAF stripping custom headers | Allow X-Public-Key, X-Quote-Token, and Idempotency-Key headers through your WAF. |
| Console errors about postMessage | Browser extension blocking iframes | Disable iframe-blocking extensions (uBlock, NoScript, etc.) or add an exception for FMV domains. |
| Overlay broken on mobile | Missing viewport meta tag | Add <meta name="viewport" content="width=device-width, initial-scale=1">. |
| ”Mixed Content” warning | Your site is HTTP | FMV requires HTTPS. Ensure your site is served over HTTPS. |
| Analytics events not appearing in GTM | window.dataLayer not defined before fmv.js loads | Ensure GTM is installed and loads before the FMV script. See Analytics events. |
Still stuck? Contact tech@fitmyvehicle.com.au — we typically respond same day during AEST business hours.