Check the App Block is Added
The most common cause is the Store Locator app block not being added to your page:
Go to Online Store > Themes in Shopify admin
Click Customize on your active theme
Navigate to the page where you expect the store locator
Check that a Store Locator section exists under Apps
If not, click Add section and select Store Locator from the Apps list
Click Save
After adding the block, refresh your store locator page.
Verify API Key Configuration
If you’re using Google Maps or Mapbox, a valid API key is required. OpenStreetMap works without a key.
For Mapbox
Go to Settings > Map Provider in Store Locator
Check that a Mapbox Access Token is entered
Verify the token at mapbox.com/account
Ensure the token hasn’t expired or been revoked
For Google Maps
Go to Settings > Map Provider in Store Locator
Check that a Google Maps API Key is entered
In Google Cloud Console, verify:
Maps JavaScript API is enabled
Geocoding API is enabled
API key restrictions allow your domain
For OpenStreetMap
No API key is needed. If the map still doesn’t show, the issue is likely theme-related.
Check Theme Compatibility
Some themes may conflict with the store locator:
Try the store locator on a default Shopify theme (Dawn)
If it works on Dawn, the issue is theme-specific
Check for JavaScript errors in browser console (F12 > Console)
Look for CSS conflicts that may be hiding the map container
Browser Console Errors
Check the browser console for specific error messages:
Open your store locator page
Press F12 to open Developer Tools
Click the Console tab
Look for red error messages
Common errors:
“API key invalid” - Check your API key in Settings
“Refused to load script” - Content Security Policy issue with your theme
“mapboxgl is not defined” - Mapbox script failed to load
Clear Cache
Sometimes cached data causes display issues:
Clear your browser cache and cookies
Try viewing in an incognito/private window
If using a CDN or caching app, purge the cache