Settings → Map field reference and override behavior
Open Store Locator → Settings → Map. These values are site-level defaults; a Layout's Map widget can override several presentation values.
| Setting | Exact effect |
|---|---|
| Map provider | Leaflet/OpenStreetMap or Google Maps frontend adapter |
| Google Maps API key (browser) | Maps JavaScript and Places autocomplete; delivered to browser |
| Google Maps API is already loaded on the frontend | Stops this plugin printing a second Maps JavaScript API script tag |
| Google server key (geocoding) | Server-side geocoding for imports and Fill missing coordinates |
| Geocoder | Nominatim or Google address-to-coordinate provider |
| Default latitude/longitude | Initial site-level map center |
| Default zoom | Initial site-level zoom |
| Search zoom | Zoom after a location search |
| Clicked zoom | Zoom after a result is selected |
| Map type (Google) | Road map, Satellite, Hybrid, or Terrain |
| Map style (Google) | Standard/preset/custom JSON styling |
| Cluster markers | Site default for marker clustering |
| Cluster style/color | Default cluster bubble shape and brand color |
| Marker click animation | None, Bounce, Pulse, or Drop |
| Marker size (px) | Icon-marker height from 12–120; width preserves aspect ratio |
| Draw radius circle | Draw active search radius around the origin |
| Mouse-wheel zoom | Allow wheel gestures to zoom the map |
| Global icon marker | Fallback icon when Store/Category does not resolve one |
| Global HTML marker | Fallback design in HTML marker mode |
Override chain
A Map widget can override map type/style, clustering/style/color, animation, markers, infobox, center, zoom, and height for one Layout. An Icon Override marker replaces Store, Category, and global icon assignments. An HTML Force marker design replaces Store, Category, and global HTML assignments.
The browser and server Google keys are not interchangeable. Follow Configure Google Maps and API keys.
Avoid loading Google Maps twice
Enable Google Maps API is already loaded on the frontend only when the active theme or another plugin loads the API before the Store Locator starts. That existing request must include the Places and Marker libraries because the locator uses them for address suggestions and modern markers. The Store Locator keeps its internal dependency handle and local marker-cluster script, but does not output another maps.googleapis.com/maps/api/js request.
Leave the setting disabled when this plugin is responsible for Google Maps. If it is enabled without another working API loader, a Google Map waits for google.maps.Map and cannot initialize, while Places suggestions remain unavailable.
Provider assets are also Layout-aware. A Layout without a Map widget does not load Leaflet or the Google Maps renderer merely because one is selected globally. A search-only Layout may still load Google Places when its Location field needs autocomplete. See Reduce Store Locator frontend assets for the exact placement matrix.