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
- Open Stores and open the missing store.
- Set Status to Active and save.
- Confirm the store has valid coordinates (
latandlng). - If coordinates are missing, update the address and save again so geocoding can run.
- 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.
- 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
| Issue | Fix |
|---|---|
| Store is visible in admin but not storefront | Set status to Active and save. Draft stores are hidden on storefront. |
| Store has no map pin | Add a complete address, save, and confirm lat/lng fields are filled. |
| Store appears only after moving map | Use paginated loading or adjust initial map center/zoom for your region. |