Check App Embed is Activated
The most common cause is the app embed being disabled:
Go to Online Store > Themes in Shopify admin
Click Customize on your active theme
Click App embeds in the left sidebar
Ensure Store Locator is toggled ON
Click Save
After enabling, refresh your store locator page.
Verify API Key Configuration
Maps require a valid API key from your map provider:
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
Check Theme Compatibility
Some themes may conflict with the store locator:
Try the store locator on a default Shopify theme (Dawn)
If it works, the issue is theme-specific
Check for JavaScript errors in browser console (F12 > Console)
Look for CSS conflicts hiding the map
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
“Refused to load script” - Content Security Policy issue
“mapboxgl is not defined” - Script loading failed
Clear Cache
Sometimes cached data causes display issues:
Clear your browser cache and cookies
Clear Shopify’s theme cache: Online Store > Themes > Actions > Clear cache
Try viewing in an incognito/private window