Last updated:
May 19, 2026
My Google Map is not Loading / is Gray
If your Google Maps background is gray or not loading, the cause is almost always a misconfigured Google Maps API key or your live domain not being added to the Website Restrictions in Google Cloud Console. Make sure the Maps JavaScript API is enabled and your live domain is whitelisted. Watch the Loom tutorial for a full walkthrough.
If your Google Maps background fails to load and appears gray, there is most likely an issue with your Google Maps API key configuration or your Google Cloud Console website restrictions.
Fix Google Maps API Settings
Make sure your Google Cloud Console API key is set up correctly:
- The Maps JavaScript API is enabled for your project.
- Your live domain is added to the Website Restrictions in your API key settings.
You can manage your API key settings here: Google Cloud Console API Credentials
Watch the step-by-step video tutorial: Loom: Set up Google Maps API Key
💡 If you'd prefer to avoid API key setup entirely, consider switching to MapLibre or Open Street Map — both are free with no API key required.
