Storemapify is a Shopify app that lets merchants display an interactive store locator map on their storefront. Customers can search for nearby stores by location or name, see distances, view store hours, get directions, and more.

---

Table of Contents

1. Setup & Getting a Google Maps API Key
2. Adding a Store — All Fields Explained
3. Editing, Deleting, and Viewing Store Details
4. Importing and Exporting Data
5. Settings Panel — All Fields Explained
6. Dashboard Widgets — What They Display and How They Work
7. Adding the Theme Extension to Your Theme
8. Theme Extension Settings — All Fields Explained
9. Frontend Store Locator — User Experience and How It Works
10. Use My Location — How It Works
11. Plans & Feature Access
12. Search Analytics (Growth Plan)
13. Frequently Asked Questions

---

1. Setup & Getting a Google Maps API Key

A Google Maps API key is required to display the interactive map on your storefront and to enable address autocomplete. Without a key the app will show a setup warning in the theme block instead of the map.

Step 1 — Create a Google Cloud project

1. Go to https://console.cloud.google.com and sign in with your Google account.
2. Click the project dropdown at the top of the page and select New Project.
3. Give the project a name (e.g. “My Shopify Store Locator”) and click Create.

Step 2 — Enable the required APIs

You need to enable three APIs for the store locator to work fully:

API	Purpose
Maps JavaScript API	Renders the interactive map on the storefront
Geocoding API	Converts text addresses to latitude/longitude coordinates
Places API	Powers the autocomplete suggestions in the search box

To enable each one:

1. In Google Cloud Console, navigate to APIs & Services → Library.
2. Search for the API by name and click Enable.
3. Repeat for all three APIs listed above.

Step 3 — Create an API key

1. Navigate to APIs & Services → Credentials.
2. Click + Create Credentials → API key.
3. Copy the generated key (it looks like AIzaSy...).

Step 4 — Restrict the API key (recommended)

To prevent unauthorized use of your key:

1. Click the pencil icon next to your new key.
2. Under Application restrictions, choose HTTP referrers (websites).
3. Add your Shopify store domain, for example: https://your-store.myshopify.com/*
4. Under API restrictions, choose Restrict key and select only the three APIs you enabled.
5. Click Save.

Step 5 — Add the key to Storemapify

1. Open the Storemapify app in your Shopify admin.
2. Navigate to Settings in the top navigation.
3. Paste your API key into the Google Maps API key field.
4. Click Save settings.

Note: The API key is also read by the theme extension from a Shopify shop metafield (store_locator.google_maps_api_key). This is set automatically when you save it in Settings. You do not need to enter it again in the theme editor.

---

2. Adding a Store — All Fields Explained

Navigate to Stores → Add store (or click the Add store button from the Dashboard) to create a new store location.

The form is divided into four sections:

---

Basic Information

Field	Required	Description
Store Name	✅ Yes	The public name of this store location. Shown on result cards and the map tooltip. Example: Downtown Flagship
Address	✅ Yes	Street address (number + street name). Example: 123 Main Street
City	✅ Yes	City the store is located in. Example: New York
State	✅ Yes	State, province, or region. Example: NY
Country	✅ Yes	Country the store is in. Example: USA
Postal Code	✅ Yes	ZIP or postcode. Example: 10001
Latitude	✅ Yes	The precise geographic latitude of the store. Example: 40.7128. Used to position the map marker. You can find the coordinates using Google Maps (right-click a location → “What’s here?”).
Longitude	✅ Yes	The precise geographic longitude of the store. Example: -74.0060.

Tip: Latitude and longitude must be exact for the store to appear correctly on the map. Use Google Maps, maps.google.com, or a geocoding tool to find coordinates.

---

Contact Information

Field	Required	Description
Phone	✅ Yes	Primary phone number. Displayed as a clickable tel: link so mobile customers can tap to call. Example: +1-555-123-4567
Fax	No	Fax number. Shown in the tooltip if provided.
Email	No	Contact email address for the store.
Website URL	No	Full URL of the store’s own website or a dedicated page. Must start with https://. A Website button appears in the map tooltip when provided.
Store Image URL	No	URL of an image representing this store (e.g. a storefront photo hosted on your CDN). Displayed at the top of result cards and tooltips. If omitted, a placeholder icon is shown.

---

Working Hours

Working hours define when each store is open. There are two modes:

Open 24/7
Check the Open 24/7 checkbox to mark the store as always open. This sets the internal value to daily 12:00 AM - 11:59 PM and the result card will display “24/7”.

Per-day schedule
When 24/7 is not checked, you can configure hours for each day of the week (Monday through Sunday):

• Toggle the checkbox next to a day name to mark it open or closed.
• For open days, choose the Open Time and Close Time using the time picker (hour, minute, AM/PM columns).
• Days with the checkbox unchecked show a Closed badge.
• Default hours for new stores are Monday–Friday 9:00 AM–6:00 PM, Saturday and Sunday closed.

The working hours are stored in a structured text format (e.g. Mon 09:00 AM - 06:00 PM; Tue 09:00 AM - 06:00 PM; ...) and parsed by both the admin dashboard (to calculate “Stores Open Now”) and the frontend theme extension (to show “Open now” / “Closed now” status on each card).

---

Store Options

Option	Description
Active	When checked, the store is visible to customers in the store locator. Uncheck to temporarily hide a store without deleting it. Defaults to checked.
Preferred location	Marks this as a featured / highlighted store. Preferred stores display a gold star badge on their result card and use a distinct green marker color on the map (configurable in theme extension settings). Useful for flagship stores or promoted locations.
Exclude from locator	Hides this store from the public storefront search even though it is still saved and active. Use this to store internal locations or locations still being set up.
Free WiFi	Indicates the store offers complimentary WiFi. A WiFi badge appears on result cards and in map tooltips when this is enabled.
Description	A free-text description of the store — special features, accessibility notes, parking information, etc. Displayed in the store detail page (Growth plan). Not shown in the main result cards or tooltips.

Click Save store to create the location. You will be redirected to the Stores list with a success message.

---

3. Editing, Deleting, and Viewing Store Details

Viewing a Store

From the Stores list, click the store name or the View (eye) icon to open the store detail page. This page shows all saved fields organized in a grid:

• Address — street, city/state, country + postal code
• Coordinates — latitude and longitude
• Status — Active/Inactive badge, Preferred, Excluded, and Free WiFi flags
• Contact — phone, fax, email
• Website — clickable link (opens in new tab)
• Working hours — raw text as stored
• Description — full description text
• Store image — image preview (if a URL was supplied)

From the detail page you can immediately Edit store or Delete store using the buttons in the top-right corner.

---

Editing a Store

1. Navigate to Stores, find the store you want to change, and click Edit (pencil icon), or open the detail view and click Edit store.
2. The edit form is identical to the create form — all fields are pre-filled with the existing values.
3. Make your changes and click Save store.
4. You will be returned to the Stores list with an “updated successfully” message.

---

Deleting a Store

1. Open the store detail view and click Delete store (red button), or click the trash icon from the Stores list row.
2. A browser confirmation dialog asks: “Delete this store?”
3. Click OK to confirm. The store is permanently removed.
4. You are returned to the Stores list with a “deleted successfully” message.

Warning: Deletion is permanent and cannot be undone. If you want to temporarily hide a store, use the Active toggle or the Exclude from locator option instead.

---

4. Importing and Exporting Data

Navigate to Import & Export in the main menu to bulk-manage store locations using CSV files.

Plan requirement: Bulk import and export require the Starter plan or higher. Free plan users see an upgrade prompt.

---

Exporting Stores

1. In the Export Stores card on the right side of the page, click Export CSV.
2. A CSV file is immediately downloaded containing all your store locations with all fields.
3. You can also download a blank CSV Template (click Download template) to see the exact column structure before preparing an import file.

CSV columns (in order):

Column	Description
name	Store name
address	Street address
city	City
state	State / region
country	Country
postal_code	Postal / ZIP code
lat	Latitude (decimal)
lng	Longitude (decimal)
phone	Phone number
fax	Fax number
email	Email address
website	Website URL
store_image	Store image URL
description	Description text
working_hour	Working hours string
preferred_location	1 = preferred, 0 = normal
exclude_from_locator	1 = hidden, 0 = visible
free_wifi	1 = Free WiFi, 0 = no
is_active	1 = active, 0 = inactive

---

Importing Stores

1. Prepare your CSV file following the column structure above (or download the template and fill it in).
2. In the Import Stores card on the left side of the page, drag and drop your CSV file onto the drop zone, or click Select File to browse.
3. The app validates the file client-side before submission:

• It checks that required columns are present.
• A validation panel shows any warnings or errors.

1. Override option: If you check Update existing stores with matching name, stores whose name column matches an existing store will be updated rather than creating duplicates.
2. Click Import Stores (enabled only after a valid file is selected).
3. A progress bar tracks the upload. When complete, a result message shows how many records were imported or updated, and any rows that were skipped.

File limits:

• Maximum file size: 10 MB
• Format: .csv (comma-separated values)

Plan limits during import:

• Starter plan allows up to 50 stores. If your import would exceed the limit, import is disabled and you are prompted to upgrade to Growth.
• Growth plan has unlimited stores.

---

5. Settings Panel — All Fields Explained

Navigate to Settings in the main menu to configure global defaults for your store locator.

---

Map Configuration

Field	Description
Google Maps API key	Your Google Maps API key (see Section 1). Required for the map to render. Stored securely and synced to a shop metafield so the theme extension can read it.
Default zoom	The initial zoom level when the map first loads, on a scale of 1 (whole world) to 21 (individual buildings). Recommended values: 10 (city-level), 12 (neighbourhood-level). The theme extension’s own zoom setting overrides this if set.
Default map view	The default Google Maps tile type: Roadmap (standard street map), Satellite (aerial photography), Hybrid (satellite with road labels), or Terrain (topographic).
Distance unit	Choose between km (kilometres) and miles. This unit is shown next to distances in search results and is also the default for the radius selector on the storefront.
Map style	An optional JSON array of Google Maps styling rules (from https://mapstyle.withgoogle.com or Snazzy Maps). Paste the JSON string here to apply a custom map theme. Leave blank for the default Google style.
Marker color	A hex color code for the standard map pin markers (e.g. #111827). Preferred-location stores use a separate color set in the theme extension settings.

Click Save settings to apply map configuration changes.

---

App Branding

Field	Plan Required	Description
Remove app branding	Starter or Growth	When checked, hides the “Powered by Storemapify” badge that appears in the bottom-left corner of the store locator block on your storefront. On the Free plan this section shows an upgrade prompt instead of the checkbox.

Click Save settings to apply branding changes.

---

6. Dashboard Widgets — What They Display and How They Work

The Dashboard is the home page of the Storemapify admin. It gives you a quick overview of your store locator performance and guides you through the initial setup.

---

Plan Banner

At the top of the dashboard a contextual banner shows your current subscription state:

State	What it shows
Free (no trial)	“Upgrade your plan” — prompts to unlock analytics, unlimited locations, etc.
Starter trial active	Trial dates (started / ends) and a button to upgrade to Growth.
Starter paid	Current plan name with a button to upgrade to Growth.
Growth trial active	Trial dates and a “Choose plan” button to convert to paid.
Growth paid	Confirmation you have full feature access and a “Manage plan” button.
Trial expired	Warning that the trial has ended with dates and an upgrade button.

---

Stat Cards (4 widgets)

These four metric tiles sit below the plan banner:

Card	What it shows	How it works
Total Stores	Count of all saved store locations in your account.	Counts all rows in your stores table regardless of active/inactive status.
Searches This Week	Number of customer searches made via your storefront locator in the last 7 days.	Each time a customer submits a search on the storefront, a Search record is saved. This card counts those records from the last 7 days.
Stores Open Now	Number of your active, non-excluded stores that are open at the current server time (UTC).	Parses each store’s working hours string against the current day and time. Stores with “Open 24/7” hours are always counted.
Location Views (last 7 days)	Number of times customers clicked on a store card to open the map tooltip / detail, in the past 7 days.	Each card click records a LocationView event. This card sums those events over the past 7 days.

---

Popular Locations Widget (Growth plan)

Shows the top 6 cities / areas where your customers have been searching, ranked by number of searches. Each row shows:

• City name — the geocoded city from the search
• Stores in that area — count of stores found in that city
• Search count — how many searches originated from that city

A dropdown lets you filter by time period: Last 24 hours, Last 7 days, Last 30 days, or Last 90 days.

On the Free and Starter plans the widget shows blurred placeholder data with an upgrade prompt overlay.

---

Setup Your Store Locator (Onboarding Checklist)

This panel is shown until all three steps are completed (or until you dismiss it). It tracks:

Step	Completion condition
✅ Add your Google Maps API key	A non-empty API key is saved in Settings.
✅ Add your first location	At least one store has been created.
✅ Add store locator to your theme	At least one search has been recorded (meaning a customer has used the locator, confirming the theme extension is live).

Each incomplete step has a shortcut link to the relevant page. Once all three steps are done the checklist is replaced by a “View Documentation” button. You can also dismiss the checklist permanently from the panel.

---

Recent Searches Widget (Growth plan)

A table showing the 5 most recent customer searches with:

Column	Description
Location	The city / address the customer searched for
Stores Found	How many stores were returned for that search
Time	How long ago the search happened (relative time)
Device	Device type detected — Mobile, Tablet, or Desktop

A View all link opens the full Searches page (Growth plan only).

On the Free and Starter plans the table shows blurred placeholder rows with an upgrade prompt overlay.

---

7. Adding the Theme Extension to Your Theme

The Storemapify theme extension adds the store locator block to your Shopify storefront. It is a Theme App Extension — a native Shopify feature that embeds directly in the Online Store editor without touching theme code.

---

Steps

1. Open your theme editor

• In your Shopify admin, go to Online Store → Themes.
• Click Customize on your active theme.

1. Create a new page template (recommended)

• In the left sidebar of the theme editor, click Pages.
• Click Add template (or create a new page in Shopify admin first: Online Store → Pages → Add page, and assign a unique title like “Store Locator”).
• Choose the Default page template as the base.

1. Add the Storemapify block

• In the left panel of the theme editor click Add section (or Add block within an existing section, depending on your theme).
• Scroll to the Apps category and click Storemapify.
• The store locator block is now inserted into the page.

1. Configure the block settings (see Section 8)

• Select the block in the left sidebar to reveal its settings on the right.

1. Save the theme

• Click Save in the top-right corner of the theme editor.

1. Link the page in your navigation

• Go to Online Store → Navigation and add the Store Locator page to your main menu so customers can find it.

Note: If the map does not appear after adding the block, verify that your Google Maps API key is saved in the app’s Settings panel. The block reads the key from a shop metafield that is populated when you save Settings.

---

8. Theme Extension Settings — All Fields Explained

When the Storemapify block is selected in the Shopify theme editor, these settings appear in the right-hand panel:

Setting	Type	Default	Description
Title text	Text	Find a Store Near You	The heading displayed above the search form on your storefront. Customize it to match your brand voice, e.g. “Find Your Nearest Store” or “Locate a Dealership”.
Default Map Zoom	Range (4–18)	10	The initial zoom level when the map first loads. 4 = continent view; 10 = city view; 14 = neighbourhood view; 18 = building-level. The map automatically re-zooms to fit search results after a search is performed.
Map Height (px)	Range (400–900 px)	600	The pixel height of the combined map + results panel. Adjust to fit your page layout. On mobile the layout stacks vertically and this setting controls the map portion’s height.
Map Marker Color	Color picker	#ce0f2d (red)	The fill color of the standard pin markers for regular store locations.
Preferred Marker Color	Color picker	#28a745 (green)	The fill color of pin markers for stores marked as Preferred location. This lets preferred/featured stores stand out visually on the map.
Default Search Radius	Select	500	The pre-selected value in the Radius dropdown when the page loads. Options: 10, 25, 50, 100, 200, 500, 1000, 2000 (in the unit configured below).
Distance Unit	Select	km	Whether distances are shown in Kilometres (km) or Miles. This setting overrides the global setting from the app’s Settings panel for the storefront display.
Results Per Page	Range (5–50)	10	How many store cards are shown per page in the results list. Customers can page through results using Previous / Next buttons if there are more stores than this limit.
Remove App Branding	Checkbox	Off	When checked (Starter / Growth plans only), hides the “Powered by Storemapify” badge. On Free plan this has no effect — branding is always shown. This setting works in combination with the app-level branding setting in Settings: if either one requests removal and the shop is on a paid plan, the badge is hidden.

---

9. Frontend Store Locator — User Experience and How It Works

When a customer visits the page where you have added the Storemapify block, here is what they see and how each part works:

---

Page Title

The heading text configured in the theme extension settings (default: “Find a Store Near You”) is displayed prominently at the top.

---

Search Form

The search form sits above the map/results area and has three field groups:

Town / City (location input)

• A text box labelled Town / City with placeholder text “City, State, ZIP Code, or Address”.
• As the customer types, Google Places Autocomplete suggests matching locations in a dropdown. Clicking a suggestion immediately triggers a search.
• A × (clear) button appears on the right side of the field once text has been entered, allowing the customer to clear the input.
• On Starter and Growth plans, a “Use my location” button appears next to the label (see Section 10).

Store (name filter)

• A secondary input labelled Store with a Filter by name toggle checkbox.
• By default the name input is disabled. When the customer checks Filter by name, the input activates and they can type a store name (e.g. Downtown Flagship).
• When both a location and a store name are provided, the results are first filtered by proximity to the location and then narrowed to exact name matches.

Radius selector and Search button

• A Radius dropdown lets the customer choose the search distance (e.g. 10, 25, 50, 100, 200, 500, 1000, 2000 km or miles). The default value is set in the theme extension settings.
• The Search button submits the form. The page does not reload — results update dynamically via a JavaScript fetch call to the store locator API.
• Changing the Radius dropdown value automatically re-runs the last search without the customer needing to click Search again.

---

Map

• A full-height Google Maps panel renders to the right of (desktop) or below (mobile) the results list.
• On page load, the map shows stores near Los Angeles, CA, USA as a default starting point with markers plotted.
• After each search the map re-centers and zooms to fit all found stores within the viewport.
• If only one store is found, the map zooms in to zoom level 11 or the radius-appropriate zoom, whichever is higher.
• Each store is represented by a custom SVG pin marker with a letter label (A, B, C…). Regular stores use the Map Marker Color; preferred stores use the Preferred Marker Color.
• The current search location is shown with an animated blue pulse dot (pulsing circle animation) when the user has searched or used “My Location”.

---

Result Cards

Each found store is displayed as a card in the results panel on the left side. Cards show:

Element	Description
Store image	Image from the store_image URL, or a placeholder store icon if no image is set
Distance badge	Distance from the searched location (e.g. 3.4 km) overlaid on the image
Preferred badge	A gold ⭐ star badge in the top-right of the image for preferred stores
Store name	Bold heading
Address	Street address on one line, then city / state / postal code on the next
Phone	Clickable tel: link so mobile users can tap to call
Working hours	Summary of opening hours (e.g. “Mon – Fri: 9:00 AM – 6:00 PM” or “24/7” or “Custom”)
Free WiFi badge	WiFi icon + “Free WiFi” label shown if the store has free_wifi enabled
Open / Closed status pill	A green “Open” or red “Closed” pill calculated in real-time from the store’s working hours and the user’s local browser time
Directions link	Links to Google Maps directions with the store’s address pre-filled as the destination

Clicking anywhere on a card (except a link):

1. Highlights the card with a blue border.
2. Centers the map on that store.
3. Zooms the map to level 14.
4. Opens the tooltip (InfoWindow on desktop, mobile card on small screens — see below).
5. Records a Location View event for analytics.

A summary line above the cards reads e.g. “12 stores found near New York, NY”.

Pagination controls (Previous / Next buttons + “Page X of Y” indicator) appear below the card list when there are more results than the configured Results Per Page limit.

---

Map Tooltip (Desktop InfoWindow)

When a customer clicks a store card or map marker on desktop, a popup tooltip (Google Maps InfoWindow) opens at the marker. It contains:

Element	Description
Store image or placeholder	Full-width image at the top; placeholder store icon if no image
Preferred badge	Gold star in the top-left corner of the image area for preferred stores
Close (×) button	Closes the tooltip and restores the map to the pre-click zoom/center
Store name	Bold heading
Open/Closed status pill + distance	Status pill (green/red) and distance text shown inline
Full address	Complete address on one line
Phone	Clickable phone link
Working hours	For stores with the same hours every day: a single line. For stores with custom per-day hours: an expandable accordion with a “See details / Hide details” toggle that lists each open day and its hours
Free WiFi badge	WiFi badge if enabled
Directions button	Primary action button linking to Google Maps directions
Website button	Secondary action button linking to the store’s website (only shown if a website URL is set)

Closing the tooltip (via the × button or clicking outside) restores the map to the zoom level and center it had before the card/marker was clicked.

---

Mobile Card (Small Screens)

On screens ≤ 900 px wide, clicking a marker or card does not open a Google Maps InfoWindow. Instead:

1. An identical info card appears below the map (the #sl-mobile-card element).
2. The map scrolls into view so the customer can see the updated marker position.
3. The mobile card has the same close button behavior as the desktop tooltip.

---

“No results” State

If no stores are found within the selected radius, the results panel shows:

No stores found
No results within [X km/miles] of your search location.
Try expanding your search radius or entering a different location.

---

App Branding

A small “Powered by Storemapify” badge with a pin icon appears in the top-left of the locator block. This can be hidden on Starter and Growth plans via the Settings panel or theme extension settings.

---

10. Use My Location — How It Works

The “Use my location” button appears next to the Town / City field label on Starter and Growth plan stores. It is hidden on the Free plan.

Flow

1. The customer clicks “Use my location”.
2. The button shows a loading state (spinner animation, class is-locating).
3. The app requests the browser’s Geolocation API (navigator.geolocation.getCurrentPosition).
4. The browser shows a permission prompt asking the customer to allow or deny location access.

If the customer allows:

• The browser returns GPS coordinates (latitude + longitude).
• If a Google Maps API key is present, the coordinates are reverse-geocoded using the Google Geocoder to get a human-readable address. The address is filled into the Town / City text field.
• If no Google API key is available, the raw coordinates (lat, lng) are placed in the field.
• A search is immediately triggered for the detected location.
• The blue pulse dot marker is placed on the map at the user’s location.

If the customer denies or an error occurs:

• An informative error message is shown in a browser alert():
• Permission denied: “Location permission was denied. Please allow location access in your browser and try again.”
• Unavailable: “Location information is unavailable. Please enter your location manually.”
• Timeout: “Location request timed out. Please try again or enter your location manually.”
• Embedded preview (theme editor): “Location access is blocked in this embedded preview. Open the storefront in a normal browser tab and try again.”

Technical Details

• The app first tries with enableHighAccuracy: true (10 s timeout, 5 min cache).
• On failure it retries with enableHighAccuracy: false (15 s timeout, 10 min cache) to improve success rate on devices where high-accuracy GPS is slow.
• The feature only works on HTTPS origins. On http:// the button checks window.isSecureContext and shows an alert immediately without requesting geolocation.
• The page must not be in an iframe without allow="geolocation". The Shopify theme editor preview is an iframe, so location will be blocked — the error message handles this case with a specific explanation.

---

11. Plans & Feature Access

Storemapify offers three tiers:

Feature	Free	Starter	Growth
Store locator map	✅	✅	✅
Address search	✅	✅	✅
Directions links	✅	✅	✅
Max store locations	5	50	Unlimited
Geolocation (“Use my location”)	❌	✅	✅
Bulk CSV import / export	❌	✅	✅
Remove “Powered by Storemapify”	❌	✅	✅
Analytics (dashboard + searches)	❌	❌	✅
Store detail pages	❌	❌	✅

Trial periods are available for both Starter and Growth plans. During a trial you have full access to the plan’s features.

---

12. Search Analytics (Growth Plan)

When on the Growth plan, the Storemapify admin gains access to detailed search analytics:

Full Searches Page

Navigate to Searches in the top menu to view a paginated table of all customer searches including:

• Location searched — the city/address entered by the customer
• Stores found — number of results returned
• Date/time — when the search was performed
• Device type — Mobile, Tablet, or Desktop (detected from the User-Agent header)

Popular Locations Dashboard Widget

The Popular Locations panel on the Dashboard (Growth plan, as described in Section 6) shows aggregated data for the top 6 searched cities, filterable by time period.

Location Views

Every time a customer clicks a store card to view its details, a Location View is recorded. The Location Views (last 7 days) stat card on the Dashboard shows the total across all stores.

---

13. Frequently Asked Questions

Q: The map is not showing on my storefront. What should I do?
A: Check that:

1. You have added a valid Google Maps API key in Settings.
2. You have enabled the Maps JavaScript API, Geocoding API, and Places API in Google Cloud Console.
3. Your API key restrictions allow requests from your store domain.
4. You have saved the Settings and refreshed your storefront.

---

Q: My stores are not appearing on the map after a search.
A: Make sure:

1. Each store has valid latitude and longitude values.
2. The store is marked Active and does not have Exclude from locator checked.
3. The search radius is large enough to include the stores (try increasing it to 2000 km as a test).

---

Q: The “Use my location” button is not visible.
A: The geolocation button is only shown on the Starter and Growth plans. If you are on the Free plan, upgrade to unlock this feature.

---

Q: I deleted a store by accident. Can I recover it?
A: Deletion is permanent and there is no built-in undo. If you exported your data recently you can re-import from that CSV. Going forward, use the Active toggle or Exclude from locator option to hide stores without deleting them.

---

Q: How do I update many stores at once?
A: Use the Export CSV feature to download your current stores, edit the CSV file, then re-import with the Update existing stores with matching name checkbox enabled. Rows whose name matches an existing store will be updated; new names will create new stores.

---

Q: The map shows an “API key not configured” notice in the theme editor preview.
A: The Shopify theme editor preview uses a different context. As long as your API key is saved in the app’s Settings and visible on your live storefront, this preview message is normal and does not affect the live site.

---

Q: Can I use a custom map style?
A: Yes. Go to Settings → Map style and paste a Google Maps style JSON array. You can generate one at https://mapstyle.withgoogle.com or browse community styles at Snazzy Maps.

---

Q: How do I add the store locator to my navigation menu?
A: In Shopify admin, go to Online Store → Navigation, open your primary menu, and add a link to the store locator page you created (e.g. /pages/store-locator).

---