Documentation
Everything you need to run Storemapify
Storemapify is a Shopify app that adds an interactive store locator to your storefront. Customers search by location or name, see distances, view hours, and get directions.
1. Setup & getting a Google Maps API key
A Google Maps API key is required to display the interactive map and enable address autocomplete. Without one, the app shows a setup warning in the theme block instead of the map.
- Create a project at Google Cloud Console.
- Enable the Maps JavaScript API, Geocoding API, and Places API.
- Create an API key under Credentials.
- Restrict it to your storefront domain (recommended).
- Paste the key into Storemapify → Settings and save.
Note: The key is also synced to a shop metafield the theme extension reads automatically — no need to re-enter it in the theme editor.
2. Adding a store — fields explained
Go to Stores → Add store. The form has four sections: Basic Information, Contact Information, Working Hours, and Store Options.
| Field | Required | Notes |
|---|---|---|
| Store name, address, city, state, country, postal code | Yes | Shown on result cards and map tooltip |
| Latitude / longitude | Yes | Must be exact — positions the map marker |
| Phone | Yes | Rendered as a tappable tel: link |
| Fax, email, website URL, store image URL | No | Website adds a button; image shows on cards |
| Working hours | — | Open 24/7 toggle, or per-day open/close times |
| Active / Preferred / Exclude / Free WiFi | — | Preferred stores get a gold badge + green marker |
3. Editing, deleting & viewing store details
Click a store’s name or the view icon to see all saved fields in a detail grid. Edit and Delete buttons sit top-right. Deletion asks for confirmation and is permanent — use the Active toggle or Exclude from locator instead if you just want to hide a store temporarily.
4. Importing and exporting data
Bulk-manage locations from Import & Export using CSV files. Requires Starter plan or higher.
- Export a CSV of all locations, or download a blank template.
- Drag-and-drop a CSV to import; client-side validation flags issues first.
- “Update existing stores with matching name” avoids duplicates on re-import.
- Max file size 10MB. Starter caps at 50 stores; Growth is unlimited.
5. Settings panel
| Field | Description |
|---|---|
| Google Maps API key | Required for the map to render |
| Default zoom | 1 (world) – 21 (building); city ≈ 10 |
| Default map view | Roadmap, Satellite, Hybrid, or Terrain |
| Distance unit | km or miles |
| Map style | Optional custom JSON styling |
| Marker color | Hex color for standard pins |
| Remove app branding | Starter/Growth only — hides “Powered by Storemapify” |
6. Dashboard widgets
The Dashboard opens with a plan status banner, then four stat cards: Total Stores, Searches This Week, Stores Open Now, and Location Views (7 days). Growth plan adds a Popular Locations panel and a Recent Searches table; both show blurred placeholders with an upgrade prompt on Free/Starter. An onboarding checklist tracks API key, first location, and theme install until all three are done.
7. Adding the theme extension
Storemapify ships as a Theme App Extension — no theme code editing required.
- Online Store → Themes → Customize on your active theme.
- Create or open a page, then Add section / Add block.
- Scroll to Apps and select Storemapify.
- Configure the block settings (see section 8).
- Save the theme, then link the page in Online Store → Navigation.
8. Theme extension settings
| Setting | Default | Description |
|---|---|---|
| Title text | Find a Store Near You | Heading above the search form |
| Default map zoom | 10 | Range 4–18 |
| Map height | 600px | Range 400–900px |
| Marker / preferred marker color | Red / Green | Color pickers |
| Default search radius | 500 | 10 to 2000 |
| Distance unit | km | km or miles |
| Results per page | 10 | Range 5–50 |
| Remove app branding | Off | Starter/Growth only |
9. Frontend store locator — how it works
Customers see a search form (Town/City with Google Places autocomplete, an optional store-name filter, and a radius selector) above a live map and a results list. Each result card shows a photo, distance badge, name, address, phone, hours, an open/closed pill, and a directions link. Clicking a card centers the map, opens a tooltip, and zooms to that store. On screens under 900px, tooltips appear as a card below the map instead of a Google InfoWindow.
10. “Use my location” — how it works
Available on Starter and Growth plans. Clicking the button requests the browser’s Geolocation API; on success, coordinates are reverse-geocoded to an address and a search runs automatically. Denied permission, unavailable location, or timeouts each show a clear inline message. Requires HTTPS and a non-blocked iframe context.
11. Plans & feature access
| Feature | Free | Starter | Growth |
|---|---|---|---|
| Max locations | 5 | 50 | Unlimited |
| Use my location | — | ✓ | ✓ |
| CSV import / export | — | ✓ | ✓ |
| Remove app branding | — | ✓ | ✓ |
| Analytics dashboard | — | — | ✓ |
| Store detail pages | — | — | ✓ |
12. Search analytics (Growth plan)
Growth unlocks a full Searches page (location, results count, timestamp, device type), a Popular Locations widget ranking the top 6 searched cities by time period, and Location View tracking whenever a customer opens a store’s details.
13. Frequently asked questions
The map isn’t showing on my storefront.
Confirm a valid API key is saved, all three Google APIs are enabled, your domain is allowed in the key’s restrictions, and Settings has been saved.
My stores aren’t appearing after a search.
Check that each store has valid coordinates, is Active and not Excluded, and that your search radius is wide enough.
I deleted a store by accident — can I recover it?
Deletion is permanent. Re-import from a recent CSV export if you have one, or use Active/Exclude instead of deleting going forward.
Can I use a custom map style?
Yes — paste a Google Maps style JSON array into Settings → Map style.
Still stuck? Open a support request or contact us directly.