> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fitmyvehicle.com.au/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Common issues and how to fix them.

| 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](/security/csp).                                 |
| "Unable to Load Widget" error inside iframe | API domain blocked by firewall                     | Whitelist `api.fitmyvehicle.com.au` and `cloud.fitmyvehicle.com.au`. See [Domains](/security/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](/configuration/analytics-events). |

<Info>
  **Still stuck?** Contact [tech@fitmyvehicle.com.au](mailto:tech@fitmyvehicle.com.au) — we typically respond same day during AEST business hours.
</Info>