How does Stockist Map Sync work?
Tag any Shopify customer with a designated tag (e.g.
stockist) and their address is automatically geocoded and displayed on an interactive map on your storefront. You can also import locations in bulk via CSV.Do I need a Google Maps API key?
No. Stockist Map Sync uses OpenStreetMap and Leaflet, which are completely free and require no API keys or external accounts.
How do I add the map to my storefront?
In your Shopify admin, go to Online Store → Customize, open the page where you want the map, and click Add block. Under Apps, choose Plynthr Stockist Map. Use the block settings to set the heading, map height, and layout. No code changes needed.
Which themes are supported?
All Shopify themes are supported, including free themes like Dawn, Refresh, Sense, and Pitch, as well as premium themes. The map is fully responsive and adapts to any layout.
How does customer tag sync work?
In the app settings, define which customer tags to sync (e.g.
stockist, retailer). Any customer with a matching tag has their address geocoded and added to the map. Changes sync automatically via webhooks.Can I import locations from a spreadsheet?
Yes. Go to Import in the app, download the CSV template, fill in your locations, and upload. Addresses are geocoded automatically. Supported columns include name, address, phone, hours, website, description, and category.
How does predictive search work?
When visitors type in the search bar, real address suggestions appear via OpenStreetMap's Nominatim service. Selecting a suggestion shows nearby locations sorted by distance.
Does the map auto-detect visitor location?
Yes. If the visitor allows browser location access, the map shows their nearest locations sorted by distance. If declined, the map uses your configured default centre and zoom.
What is the difference between plans?
The only difference is location count. Free supports up to 10 locations, Pro up to 250, and Business is unlimited. All features are included in every plan.
Can I change my plan at any time?
Yes. Upgrade or downgrade at any time via the Shopify admin. Pro and Business plans include a 14-day free trial.
How do I customise the map appearance?
Go to Settings to choose from 5 map styles, set your marker colour, configure the default centre and zoom, and adjust the search radius.
I changed a stockist's address but the map still shows the old one
Open the app and click Sync Now. If any addresses couldn't be placed on the map, the app tells you which ones and why. The usual cause is an address the mapping service can't resolve — a missing suburb or postcode, a typo, or a PO box. Check the customer's default address in Shopify (that's the one used), then sync again. Storefront responses are cached for a few minutes, so allow 2–5 minutes before checking your live page.
Some of my stockists are missing from the map
Check three things, in order. Plan limit: Free shows 10 locations, Pro 250, Business unlimited — over the limit, extra locations are hidden and the app shows a banner. The tag: only customers carrying a tag listed in Settings are synced, and tags must match exactly. The address: a customer with no default address, or one that can't be located, is skipped — run a sync and skipped locations are listed by name.
Do I need to sync manually every time?
No. Tagging, editing, or removing a customer updates the map automatically within a minute or two, and the app re-checks every location once a day so your map stays current on its own. Sync Now is there for bulk changes, CSV imports, and to confirm everything's up to date.
Why do changes take a few minutes to appear?
Shopify's App Proxy caches responses for a few minutes. After saving or syncing, changes may take 2–5 minutes to appear on your live storefront.
How do I contact support?
Email us at [email protected] and we'll get back to you as quickly as possible.
