Choose a map provider
Open LoyalMLS Bridge → Settings → Connection and scroll to Maps.
- OpenStreetMap (Leaflet — free, no key required) is the default. Pick a Map Style: Standard, Cycle Map, Dark (CartoDB), Light (CartoDB) or Watercolor (Stamen).
- Google Maps (requires an API key) shows a Google API Key field. The key needs the Maps JavaScript API enabled in your Google Cloud project; restrict it to your domain. Until a key is saved, maps fall back to OpenStreetMap.
Google bills Maps usage to the account that owns the key, under Google’s own terms.
Clustering
With Cluster markers on (the default), nearby listings are grouped into bubbles that show how many listings they hold.
Group clusters by decides how:
- Area (County → City → Neighbourhood) counts listings by where they’re filed: counties when zoomed out, cities from zoom level 9 and neighborhoods from zoom level 12. Past zoom level 16 the map uses a grid, which turns into pins once a view is sparse. Clicking a bubble zooms to that area, and hovering shows its name.
- Map grid groups listings by their position on the map at every zoom level.
For the Area option, Neighbourhood level picks the field used at the finest level: Subdivision, MLS Area (Major) or MLS Area (Minor). Choose the one your MLS fills in most consistently. Listings filed under no area still appear, as unnamed bubbles.
Show pins below (default 500, up to 2,000) switches a view to individual pins at any zoom when it holds that many listings or fewer.
With clustering off, Markers on the map limits how many pins are drawn (0 shows as many as the list holds, up to 1,000).
Markers
- Marker style: Pin, or Price, which shows each listing’s price on its marker.
- Marker Colours: click Add Marker Colour, name the rule, pick a color and set a condition, for example a different color for pending listings. The first rule that matches a listing wins.
Where maps appear
| Where | How |
|---|---|
| Results and listing grids | In + Create Shortcode, set Map to above, left or right of the listings (see Built-in layouts) |
| Elementor listings pages | The LoyalMLS — Listings widget can add a map beside or above results, with Search as I move the map |
| Listing detail pages | The Location Map widget (Widgets tab): an Interactive map, or a Static image, which needs a Google key |
| Elementor detail templates | The LoyalMLS — Map widget. It can override the site’s map provider, and Blur Location shows an area instead of the exact spot |
Check your maps
- Zoom from the whole market down to a street and check that bubbles split into sensible areas.
- Open a bubble’s area and a single pin’s pop-up on a phone.
- If you use Google Maps, open your browser’s developer console on a map page; Google reports key or billing problems there.
Next step
Continue with Listing URLs and SEO settings.
Stuck on a step? Existing customers can reach Loyal Techno Group support. Planning a new site? Start with an MLS review.
