Store Locator documentation

Installation

Store Locator installs from the Shopify App Store and needs no code changes to your theme. The whole install takes a few minutes.

1. Open the Store Locator listing on the Shopify App Store and click Install.
2. Approve the requested permissions. Store Locator asks for read access to your shop details and write access to its own app metafields — it does not request customer or order data.
3. You land on the Store Locator dashboard inside Shopify admin.
4. Add your first location manually, or import a CSV of locations.
5. Add the map to a page using the theme app block (see below) and preview your storefront.

Configuration

Everything is configured from the Store Locator dashboard in Shopify admin. There are three things worth setting up before you go live: locations, search behaviour, and the map provider.

Adding locations

Each location has a name, address, phone, email, business hours, tags and an optional description. Tags drive filtering on the storefront — for example "pickup", "flagship" or "stockist".

Bulk import

For more than a handful of stores, use CSV import. Download the sample file from the dashboard, keep the header row, and upload. Addresses are geocoded on import; rows that fail to geocode are listed so you can fix them.

name,address,city,state,country,postal_code,phone,email,tags,hours
Bandra Flagship,24 Hill Road,Mumbai,Maharashtra,IN,400050,+91 22 1234 5678,bandra@example.com,"flagship,pickup",Mon-Sat 10:00-20:00
Pune Stockist,88 FC Road,Pune,Maharashtra,IN,411005,+91 20 8765 4321,pune@example.com,stockist,Mon-Fri 11:00-19:00

Map provider

Store Locator works with or without a Google Maps API key. Without a key it renders an address-list layout with directions links. With a key you get the interactive map, clustering and in-map directions. Paste the key into Settings → Map provider.

Theme app block placement

Store Locator ships as a theme app block, so you place it visually in the theme editor — no Liquid editing on Online Store 2.0 themes.

1. In Shopify admin go to Online Store → Themes → Customize.
2. Create or open the page you want the locator on (a dedicated "Store locator" page works best).
3. Click Add block (or Add section) and pick Store Locator under Apps.
4. Set the block height, default zoom, and whether search or the list loads first.
5. Save, then open the page on your storefront to confirm it renders.

Vintage themes

On themes that do not support app blocks, add the locator with an app embed snippet in the template where you want it:

{% render 'digimaa-store-locator', height: 560, zoom: 11 %}

Data and privacy

Store Locator stores the location data you enter — store names, addresses, contact details, hours and tags. That is business data, not customer data.

• No customer names, emails, orders or carts are read or stored.
• If a shopper uses "near me", the browser geolocation coordinate is used in-request to sort results and is not persisted.
• Uninstalling the app removes its storefront output immediately; stored location data is deleted after 30 days, so a reinstall inside that window keeps your setup.
• Google Maps requests are made from the shopper's browser under your own API key when a key is configured.

See the DiGiMAA privacy policy and DPA for the full picture, including subprocessors.

Troubleshooting

The map area is blank

Almost always an API key problem. Open the browser console on the page — a Google Maps key error names the exact cause (referrer restriction, billing not enabled, or Maps JavaScript API not enabled on the project).

A location shows in the wrong place

The address geocoded loosely. Open the location and set latitude and longitude manually; a manual coordinate always wins over geocoding.

CSV import rejected rows

Keep the header row from the sample file, use two-letter country codes, and wrap any value containing a comma in double quotes.

The block does not appear in the theme editor

Confirm the app is installed on the same store you are editing and that the theme is an Online Store 2.0 theme. On vintage themes use the render snippet above.

FAQ

Is there a limit on locations?

The free plan covers 3 locations. Paid plans are unlimited — the pricing difference is features, not a per-location fee.

Do I need a Google Maps API key?

No. Without a key you get a searchable address list with directions links. With a key you get the interactive map.

Does it support regional languages?

Yes. Location names, addresses and descriptions accept any Unicode text, including regional-language scripts, in both the dashboard and CSV import.

Will it slow my storefront down?

The block loads on the page where you place it and nowhere else. Map assets load only when that block enters the viewport.

Who answers support?

The team that builds the app, from Mumbai. First reply within one business day.