My page shows "This map may not work correctly"

If your store locator is showing a darkened map marked For development purposes only or an error saying This map may not work correctly, this indicates that Google has disabled your Google Maps key.

You can follow the steps on this page to fix the error so your map can display normally.

The error usually looks like this:

Why is this happening?

When you originally set up your store locator, you created a map key directly with Google, and added this key to our app to power the map and search on your site.

This error indicates that Google has temporarily disabled your Google Maps key due to a billing issue. There are a few specific causes which are covered below.

Simple fix: Switch to Mapbox

If you’d just like to get your map working again as quickly as possible, the easiest option is to switch to our alternative map provider, Mapbox:

Creating a key with Mapbox only takes a minute or two, and they don’t ask for any billing details. Your existing store locator can work with Mapbox simply by setting up a Mapbox key; you don’t need to re-enter your store details or repeat any other setup steps.

Fixing the error

If you'd prefer to continue using Google Maps on your site, you’ll need to log into the Google dashboard with the Google account that was used to originally create the key.

There are a few possible causes for the error:

#1 Your “free trial” has ended

Google's trial and free credit situation can be a little confusing, but it generally boils down to this:
When you first create your map key, your Google Maps account is in “free trial” mode. This trial lasts for up to one year, or until you use $300 worth of map services, whichever comes first.
Once your trial runs out, Google will pause your account (often with no notice) and your maps will stop working and show the error above. To fix things, you‘ll need to log in and “upgrade” your account from free trial mode to a full account.
Does this mean you’ll start being charged? No, not necessarily. Google offers a separate, ongoing $200/mo credit towards your map usage. As long as your site uses less than $200/mo, you won’t be charged. This is usually enough for 10,000 - 15,000 visits to your store locator page each month, and 99% of our clients use less than this.
To see if this is the problem, check if you're prompted to upgrade your account by one of the following:
  1. Follow this link to upgrade your account and enable billing if prompted.
  2. If the link above doesn't work, log into the Google dashboard and look for a banner near the top indicating that your trial has ended, then click the Upgrade button:
  3. Alternatively, Google may show an icon which you can click to upgrade:
  4. Finally, if you don’t see this banner, navigate to the Billing section to check if you're prompted to upgrade. Click the menu icon in the top-left corner (three horizontal bars next to Google Cloud Platform) and click Billing.
To ensure you don't see any unexpected bills, consider setting up Google Maps billing alerts and/or limiting your map usage with quotas.

#2 Your billing account hasn’t been set up

If you created your Google Maps key before Google started requiring billing details in 2018, your key may not be linked to a payment method, and your maps will show the error above.

#3 Your billing details are out-of-date

Another possible reason why your maps are no longer working could be that your billing details are incorrect. If your credit card has expired or has been closed, Google may have paused your map service until you update your details.

To check for this, log into the Google dashboard and confirm that your billing details look correct.

Other causes

The items above represent the most common reasons for these errors, but there are also a few less common causes. If the steps above haven’t helped, we recommend following Google’s full step-by-step troubleshooting guide here.

Need help?

If none of the steps above seem to fix the issue, please reach out to us using the “Contact Us" link at the top of the page, and we’ll be happy to help.