Help Center
Short, practical guides for getting Mapstore working end to end. Each article focuses on one task and includes steps, verification, and fixes.
Getting Started
Installation, setup, and first steps with Mapstore
Add Mapstore blocks to your theme
Add app blocks and app embeds in the Shopify theme editor.
Launch checklist for your store locator
Use a short pre-launch checklist before going live.
Set up Mapstore for a Shopify store
Install and open Mapstore, then complete the initial setup.
Understand Mapstore pages and navigation
Learn what each Mapstore admin page is used for.
Importing Data
CSV uploads and Google Sheets sync
Choose between manual entry, CSV upload, and Google Sheets sync
Pick the best store management workflow for your team.
Import stores from a CSV file
Upload a CSV file and import store locations in bulk.
Import stores from a CSV URL
Import stores using a direct URL to a CSV file.
Preparing a CSV file for store import
Format your CSV correctly so imports work on the first try.
Replace existing CSV-imported stores safely
Replace existing CSV data without removing manually managed stores.
Syncing store locations from Google Sheets
Connect a published Google Sheet and keep store data in sync.
Understand skipped rows and import warnings
Fix common CSV problems when rows are skipped during import.
Use the Google Sheets template and publish it correctly
Prepare and publish a Google Sheet in the required CSV format.
Managing Stores
Organize, filter, and maintain your store locations
Create and edit store locations
Add stores manually and update details like address and contact info.
Filter and sort stores in the dashboard
Use filters, search, and sorting to find stores quickly.
Set a Google Place ID for a store
Add a Place ID to a store and sync ratings and opening hours.
Set up store filters for storefront search
Use filter tags so shoppers can narrow down store results.
Understand sheet-managed stores and edit limitations
Understand how Google Sheets managed stores behave in the dashboard.
Use bulk actions (status, pinning, delete, Google sync)
Update many stores at once from the Stores list.
Use custom directions URLs and marker images
Set per-store marker icons and custom directions links when needed.
Using custom fields for store locations
Create extra fields and show them on your store locator.
Customization
Styling, themes, and branding options
Changing map styling and storefront text
Adjust map appearance and storefront labels to match branding.
Choose a map style (predefined vs custom style JSON)
Use built-in map styles or connect your own style JSON URL.
Configure map behavior (loading, sorting, filters, directions)
Set loading strategy, sorting, filters, location, and directions behavior.
Customize style settings (colors, typography, spacing, button states)
Adjust Mapstore style settings in your app embed controls.
Customize text labels and storefront copy
Change storefront text labels shown in the map and list.
Features
Analytics, lead generation, and Google integration
Export insights data as CSV/ZIP
Download analytics exports and receive them by email.
Set up lead forms for location contact
Create a lead form, choose fields, and send submissions by email.
Setting up Google Maps reviews and business hours
Connect Google Places data to show ratings and business hours.
Track where a product is available across stores
Assign products to stores and customize product availability display.
Understand insights metrics (search, filter, click, total)
Understand what each Insights metric means and how to use it.
Migration
Switch from other store locator apps with confidence
Map old fields to Mapstore CSV columns
Translate old export columns into Mapstore import columns.
Migrate from another store locator to Mapstore
Move existing location data from another app into Mapstore.
Validate imported data before replacing old stores
Run safe checks before replacing existing location data.
Integrations
API access and third-party connections
Configure Google API key and required APIs
Set up your Google API key and validate required API access.
Understand Shopify app proxy requirements for Mapstore APIs
Understand how app proxy validation protects Mapstore API requests.
Use Mapstore storefront API endpoints in themes
Fetch store data from Mapstore APIs inside your storefront theme.
Troubleshooting
Fix common issues and problems
Address geocoding failed during import
Fix geocoding failures when importing or syncing many stores.
Google reviews and hours are not updating
Troubleshoot why rating and business hours data does not refresh.
Google Sheets URL is invalid or not syncing
Diagnose URL and sync settings issues for Google Sheets.
Store does not appear on the storefront map
Check the most common reasons a store is missing on the storefront.