Google Maps Troubleshooting

1. “Something went wrong” on the map

This error typically appears when your Store Locator page URL hasn't been authorized in your Google Maps API settings. To fix it, add your store locator URL to the Google Maps API Referrer list. See this article for step-by-step instructions. Additionaly, please check:

The website domains were added correctly (including asterisks and slashes)
The URL in your browser matches one of the allowed domains

(for example, if you do not see the myshopify.com URL, it most likely has not been added to the allowed domains list.)
The API key you edited matches the key added in StoreLocator → Api Key

👉 You can click Show key in the Google dashboard and compare the last characters.

2. I can’t find my Google Maps API Key

If your key isn’t listed in the dashboard:

Check the project selector at the top and try any other listed projects
Try signing into any other Google account that may have been used

Unfortunately, Google does not provide a way to identify which email address was used to create a specific API key.

If you’re unable to locate your key, an easy alternative is to switch to default map provider.

Your existing store locations and map settings will continue working with it.

3. "This Map May Not Work Correctly" or "For Development Purposes Only"

This warning — sometimes shown as a darkened map — indicates a billing issue with the Google Maps key connected to your app. Google requires up-to-date billing details to serve maps, even within the free tier.

Common reasons this appears:

Your Google free trial has ended
Your billing account hasn't been set up
Your billing details are outdated

For a full troubleshooting guide, see this article.

Do you need help?

If you have any questions or run into issues, please contact us — we’re happy to help.