If your store locator isn't showing a map, don't panic. It's almost always one of a few simple things. This guide covers the most common causes and how to fix them.

Check your API key first

The most common reason for a map not loading is a missing or invalid API key. Head to your Map Provider settings and make sure your Google Maps API key or Mapbox access token is entered and saved.

If the field is empty, you'll need to create one. Follow our guide for Google Maps or Mapbox.

Google Maps: common fixes

All four APIs need to be enabled

Google Maps requires four separate APIs to be turned on in your Google Cloud Console. If even one is missing, the map can fail silently. Make sure these are all enabled:

Maps JavaScript API (renders the map)
Geocoding API (converts addresses to coordinates)
Geolocation API (detects visitor location)
Places API (powers the address search)

Your domain needs to be in the allowed list

If you restricted your API key to specific domains (which you should), make sure your website is listed. Go to Google Cloud Credentials, click your key, and check the HTTP referrer list. Add your domain in this format: *yourdomain.com/*

Don't forget to also add *storerocket.io/* so the preview in your dashboard works.

Billing needs to be enabled

Google requires an active billing account even if you stay within the free tier. If billing isn't set up, the map won't load at all. Go to Google Cloud Billing and link a billing account to your project.

Mapbox: common fixes

Check your access token

Go to Map Provider settings and verify your Mapbox token is correct. You can find your token at mapbox.com/account/access-tokens.

Make sure the token has the right scopes enabled. The default public token works fine for most setups.

"Store locator is loading..." stuck

If you see the message "Store locator is loading from StoreRocket Store Locator App..." and it never goes away, the widget script failed to load. A few things to check:

Are you using the latest embed code? Go to Widget > Install and copy the embed code again. Older versions may not work correctly.
Is something blocking the script? Ad blockers, privacy extensions, or your website's Content Security Policy can prevent external scripts from loading. Try in an incognito window with extensions disabled.
Check the browser console. Right-click the page, select "Inspect", go to the Console tab. Look for red error messages, they usually point to the exact problem.

"For development purposes only" watermark

This Google Maps watermark means billing isn't active on your Google Cloud account. Go to Google Cloud Billing, link a billing account, and the watermark will disappear. You won't be charged unless you exceed 10,000 map loads per month.