Frequently Asked Questions
General
Do I need a Google Maps API key?
Yes. Store Locator Map: SE uses the Google Maps Platform to render maps and geocode addresses. You must create a project in the Google Cloud Console, enable the required APIs (Maps JavaScript API and Geocoding API at minimum), and enter the resulting API key in Settings > Google Maps within the app.
Google provides a $200 monthly credit, which is sufficient for most Shopify stores.
Is the app free?
Store Locator Map: SE offers a free plan with core features and a limited number of locations. Paid plans unlock additional locations, advanced customization, analytics, and priority support. Visit the app's pricing page on the Shopify App Store for current plan details.
Does the app work on mobile devices?
Yes. The store locator widget is fully responsive and adapts to all screen sizes -- desktop, tablet, and mobile. Touch gestures (pinch to zoom, swipe to pan) are supported on the map.
Locations
What is the maximum number of locations I can add?
The maximum depends on your plan:
| Plan | Location Limit |
|---|---|
| Free | 25 |
| Basic | 250 |
| Pro | 1,000 |
| Enterprise | Unlimited |
Contact support if you need a custom limit.
Can I import locations from a CSV file?
Yes. Navigate to Locations > Import and upload a CSV file. The expected format is:
| Column | Required | Description |
|---|---|---|
name | Yes | Store display name. |
address_line1 | Yes | Street address. |
address_line2 | No | Suite, unit, or floor. |
city | Yes | City name. |
state | Yes | State or province code. |
zip | Yes | Postal or zip code. |
country | Yes | Two-letter country code (e.g., US, CA, GB). |
phone | No | Phone number. |
email | No | Contact email. |
hours | No | Business hours as a single text string. |
tags | No | Comma-separated tags (e.g., flagship,repair-center). |
A sample CSV template is available for download on the import page.
Are locations geocoded automatically?
Yes. When you add or import a location, the app uses the Google Geocoding API to convert the address into latitude and longitude coordinates. If geocoding fails for a particular address, the app flags the location and prompts you to correct it.
Customization
Can I customize the map style?
Yes. You can choose from several preset map themes or paste a custom JSON style array in Settings > Appearance > Custom Map Style. Custom styles can be generated using tools like Snazzy Maps or the Google Maps Styling Wizard.
Can I use custom marker icons?
Yes. Upload a custom marker image (PNG or SVG, recommended size 40x40 pixels) in Settings > Appearance > Marker Icon. You can also assign different icons to different location tags for visual differentiation.
Can I add the store locator to multiple pages?
Yes. You can add the store locator widget to as many pages as you need. Use the app block in the theme editor for Online Store 2.0 themes, or paste the embed code on any custom page or Liquid template. Each instance shares the same location data.
Search
What search options do customers have?
Customers can search by:
- Zip code or postal code.
- City or town name.
- Full or partial street address.
- Current location (using the browser's geolocation API, with the customer's permission).
If the Places API is enabled, the search bar also offers autocomplete suggestions.
Can I set a default search radius?
Yes. Configure the default radius in Settings > Search > Default Radius. You can also allow customers to select their own radius using a dropdown or slider on the widget.
Pricing and Billing
How does billing work?
Billing is handled through the Shopify App Store. Charges appear on your regular Shopify invoice. There is no separate payment system to manage.
Can I switch plans?
Yes. You can upgrade or downgrade your plan at any time from the app's settings. Changes take effect immediately and are prorated for the remainder of the billing cycle.
Next Steps
- Troubleshooting -- Solutions for common technical issues.
- Contact Support -- Get in touch with the Scrollengine team.