Troubleshooting Updated 2026-02-22

Store does not appear on the storefront map

What this article helps you do

A store you added is not showing on the storefront map. This guide walks you through the usual causes and how to fix them.

Before you start

  • Open Mapstore admin and your storefront in separate tabs
  • Make sure you can edit stores in Stores
  • Know which store is missing so you can check it directly

Step-by-step instructions

  1. Open Stores and open the missing store.
  2. Set Status to Active and save.
  3. Confirm the store has valid coordinates (lat and lng).
  4. If coordinates are missing, update the address and save again so geocoding can run.
  5. Check your map loading settings:
    • If using view loading, pan/zoom to the store area.
    • If needed, switch to paginated loading so stores are not limited by current map bounds.
  6. Refresh the storefront page and test again.

How to verify it worked

The store should appear on the map or in the store list. If you use view-based loading, pan the map to the store’s region.

Common issues and fixes

IssueFix
Store is visible in admin but not storefrontSet status to Active and save. Draft stores are hidden on storefront.
Store has no map pinAdd a complete address, save, and confirm lat/lng fields are filled.
Store appears only after moving mapUse paginated loading or adjust initial map center/zoom for your region.