Skip to content
Help Center Pasilobus Help Center home

Map Not Showing

Fix issues with the map not displaying

Check the App Block is Added

The most common cause is the Store Locator app block not being added to your page:

  1. Go to Online Store > Themes in Shopify admin
  2. Click Customize on your active theme
  3. Navigate to the page where you expect the store locator
  4. Check that a Store Locator section exists under Apps
  5. If not, click Add section and select Store Locator from the Apps list
  6. 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

  1. Go to Settings > Map Provider in Store Locator
  2. Check that a Mapbox Access Token is entered
  3. Verify the token at mapbox.com/account
  4. Ensure the token hasn't expired or been revoked

For Google Maps

  1. Go to Settings > Map Provider in Store Locator
  2. Check that a Google Maps API Key is entered
  3. 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:

  1. Try the store locator on a default Shopify theme (Dawn)
  2. If it works on Dawn, the issue is theme-specific
  3. Check for JavaScript errors in browser console (F12 > Console)
  4. Look for CSS conflicts that may be hiding the map container

Browser Console Errors

Check the browser console for specific error messages:

  1. Open your store locator page
  2. Press F12 to open Developer Tools
  3. Click the Console tab
  4. 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

Geolocation Not Working

If the map is set to Geolocate nearby stores but isn't detecting your customer's location:

  1. Browser permission — The customer must allow the location permission prompt. If they previously denied it, they need to reset the permission in their browser's site settings (click the lock icon in the address bar).
  2. HTTPS required — Geolocation only works on secure (HTTPS) connections. Shopify stores always use HTTPS, but if you're testing on a custom domain, make sure SSL is active.
  3. Incognito/private mode — Some browsers block geolocation by default in private browsing. Test in a regular browser window.
  4. VPN or network restrictions — Corporate networks and VPNs can block or interfere with browser geolocation.

If geolocation fails, the store locator automatically falls back to showing all locations on the map.

Clear Cache

Sometimes cached data causes display issues:

  1. Clear your browser cache and cookies
  2. Try viewing in an incognito/private window
  3. If using a CDN or caching app, purge the cache