# Mapstore

> Mapstore is a Shopify store locator app that helps merchants publish
> searchable store maps, manage location data, import stores from CSV or Google
> Sheets, show Google ratings and hours, track store locator activity, and
> capture leads from shoppers.

Use this file as a public guide to the Mapstore website. The canonical website
is `https://usemapstore.com`. For product evaluation, start with the homepage
and its sections. For setup or support questions, use the Help Center and the
task-specific articles below.

## Primary Pages

- [Homepage](https://usemapstore.com/): Product overview for Shopify merchants evaluating Mapstore.
- [Help Center](https://usemapstore.com/help/): Step-by-step setup, configuration, migration, and troubleshooting guides.
- [Privacy Policy](https://usemapstore.com/privacy-policy/): Privacy details for Shopify merchants and storefront visitors.
- [Shopify App Store Listing](https://apps.shopify.com/mapstore): Install Mapstore or review its Shopify App Store listing.

## Product Overview

- [Features](https://usemapstore.com/#features): Store locator search, filters, imports, customization, analytics, and lead capture.
- [Pricing](https://usemapstore.com/#pricing): Public pricing information for Mapstore plans.
- [How It Works](https://usemapstore.com/#how-it-works): High-level procedure to launch a Shopify store locator.
- [Use Cases](https://usemapstore.com/#use-cases): Common merchant scenarios and store locator use cases.
- [Integrations](https://usemapstore.com/#integrations): Shopify, Google Maps, Google Sheets, and related integration context.
- [Migration](https://usemapstore.com/#migration): Move location data from a different store locator app to Mapstore.
- [FAQ](https://usemapstore.com/#faq): Common buyer questions about Mapstore.

## Comparisons

- [Mapstore vs Storemapper](https://usemapstore.com/compare/mapstore-vs-storemapper/): Pricing and feature comparison with Storemapper for Shopify merchants.
- [Mapstore vs Stockist](https://usemapstore.com/compare/mapstore-vs-stockist/): Pricing and feature comparison with Stockist for Shopify merchants.
- [Mapstore vs Storepoint](https://usemapstore.com/compare/mapstore-vs-storepoint/): Pricing and feature comparison with Storepoint for Shopify merchants.

## Getting Started Help

- [Install Mapstore](https://usemapstore.com/help/installing-store-locator/): Install Mapstore, add a store, and add the map to your theme.
- [Check your store locator before launch](https://usemapstore.com/help/launch-checklist-for-your-store-locator/): Check stores, the map, search, filters, and optional features.
- [Add Mapstore to your theme](https://usemapstore.com/help/add-mapstore-blocks-to-your-theme/): Add app blocks and app embeds in the Shopify theme editor.
- [Mapstore admin pages](https://usemapstore.com/help/understand-mapstore-pages-and-navigation/): See what each Mapstore admin page contains.
- [Add email recipients](https://usemapstore.com/help/notification-emails/): Add email addresses that receive Mapstore notifications.

## Importing Data Help

- [Prepare a CSV file](https://usemapstore.com/help/preparing-csv-file-for-upload/): Add the required columns and format store data for import.
- [Import stores from a CSV file](https://usemapstore.com/help/import-stores-from-a-csv-file/): Upload a CSV file and import store locations in bulk.
- [Import stores from a CSV URL](https://usemapstore.com/help/import-stores-from-a-csv-url/): Import stores from a direct CSV URL.
- [Preview a CSV import or Google Sheets sync](https://usemapstore.com/help/preview-bulk-imports/): Check planned changes and skipped rows without changing store data.
- [Replace CSV-imported stores](https://usemapstore.com/help/replace-existing-csv-imported-stores-safely/): Replace imported store data without deleting manually managed stores.
- [Fix skipped CSV rows](https://usemapstore.com/help/fixing-csv-validation-errors/): Find and fix CSV rows that Mapstore skips.
- [Choose how to add stores](https://usemapstore.com/help/choose-between-manual-entry-csv-upload-and-google-sheets-sync/): Compare manual entry, CSV import, CSV URL, and Google Sheets sync.
- [Sync stores with Google Sheets](https://usemapstore.com/help/syncing-stores-google-sheets/): Connect a published Google Sheet and update store data.
- [Prepare a Google Sheet](https://usemapstore.com/help/use-the-google-sheets-template-and-publish-it-correctly/): Create and publish a Google Sheet in CSV format.

## Managing Stores Help

- [Add or edit stores](https://usemapstore.com/help/create-and-edit-store-locations/): Add and update store records manually.
- [Update several stores](https://usemapstore.com/help/managing-stores-bulk/): Change or delete several stores from the Stores list.
- [Find stores in Mapstore](https://usemapstore.com/help/filter-and-sort-stores-in-the-dashboard/): Search, filter, and sort stores in Mapstore.
- [Add store filters](https://usemapstore.com/help/filter-tags/): Add filter tags that shoppers can use in the store locator.
- [Add a Google Place ID](https://usemapstore.com/help/set-a-google-place-id-for-a-store/): Add a Place ID and sync ratings and opening hours.
- [Add custom fields](https://usemapstore.com/help/custom-fields/): Create fields and show them in the store locator.
- [Change a store marker or directions link](https://usemapstore.com/help/custom-marker-images/): Set a marker image or directions link for one store.
- [Stores from Google Sheets](https://usemapstore.com/help/understand-sheet-managed-stores-and-edit-limitations/): See which fields are controlled by Google Sheets.
- [Export stores](https://usemapstore.com/help/export-store-locations/): Receive all Mapstore locations in a ZIP file by email.

## Customization Help

- [Change map style and text](https://usemapstore.com/help/changing-app-styling/): Change the map design and storefront labels.
- [Change the map design](https://usemapstore.com/help/custom-map-styles/): Use a built-in map design or add a map style URL.
- [Change map settings](https://usemapstore.com/help/choosing-paginated-vs-view-loading/): Change loading, sorting, filters, location, and directions.
- [Change store locator styles](https://usemapstore.com/help/configure-style-settings-colors-typography-spacing-button-states/): Change colors, font sizes, spacing, and button states.
- [Change store locator text](https://usemapstore.com/help/customizing-text/): Change text shown in the map and store list.

## Features Help

- [Show Google ratings and hours](https://usemapstore.com/help/google-maps-reviews-hours/): Add a Google Place ID to show ratings and business hours.
- [Set up the contact form](https://usemapstore.com/help/lead-generation-form/): Create a form that appears when no stores match.
- [View store locator activity](https://usemapstore.com/help/analytics-dashboard/): See searches, filters, and other actions in the store locator.
- [Export store locator activity](https://usemapstore.com/help/exporting-store-data/): Receive recorded store locator activity in a ZIP file by email.
- [Show product availability by store](https://usemapstore.com/help/track-where-a-product-is-available-across-stores/): Show store availability on product pages.

## Integrations Help

- [Connect an AI client with MCP](https://usemapstore.com/help/connect-ai-client-with-mcp/): Connect an AI client to Mapstore, choose its access, and use store tools.
- [Set up a Google API key](https://usemapstore.com/help/configure-google-api-key-and-required-apis/): Add a Google API key and test Places API (New) and Geocoding API.
- [Get store data with the API](https://usemapstore.com/help/api-fetch-store-data/): Use Mapstore's public storefront API in theme JavaScript.
- [Allow website access to store data](https://usemapstore.com/help/securing-mapstore-app-proxy-requests/): See which websites can request store data.

## Migration Help

- [Move stores to Mapstore](https://usemapstore.com/help/migrating-from-any-store-locator-app/): Move existing location data into Mapstore.
- [Match CSV columns](https://usemapstore.com/help/map-old-fields-to-mapstore-csv-columns/): Change source export columns to Mapstore import columns.
- [Check a CSV before replacement](https://usemapstore.com/help/validate-imported-data-before-replacing-old-stores/): Preview a replacement CSV before it changes stores.

## Troubleshooting Help

- [Fix a Google Sheets URL](https://usemapstore.com/help/debugging-google-sheets-sync-failures/): Fix Google Sheets URL and sync settings.
- [Fix stores without map coordinates](https://usemapstore.com/help/resolving-geocode-failures-at-scale/): Fix imported stores that do not have map coordinates.
- [Fix a store missing from the map](https://usemapstore.com/help/fixing-stores-not-on-map/): Check status, coordinates, and map loading settings.
- [Fix Google ratings and hours](https://usemapstore.com/help/google-reviews-and-hours-are-not-updating/): Check the Place ID, API key, and Google API access.

## Contact

- [Email Mapstore Support](mailto:djordje@usemapstore.com): Contact Mapstore for support or product questions.

## Optional

- [Sitemap](https://usemapstore.com/sitemap-index.xml): XML sitemap with a full index of public pages.