Documentation menu

Browse & search

Map view

Full-screen map browsing, price pins, pin cards, saved searches, and the homepage map hero.

No API key needed

The map uses Leaflet and MapLibre GL with open OpenFreeMap tiles — OpenStreetMap tiles where vectors cannot be drawn — and an optional Esri satellite layer. Visitors switch with the Map / Satellite control. Neither provider requires an account, a key, or a billing card.

Map view of London with a price pin for every listing, under the search and filter bar

Where the map appears

SurfaceURL / block
Property archive map view/properties/map/
Taxonomy map view/property-location/lisbon/map/, and any other term archive
HomepageThe Hero Map and Locations Map widgets
Listing pageThe Property Address & Map block
Contact / about pagesThe Office Map widget

Listings need coordinates

A pin exists only when the listing has latitude and longitude. Set them in the listing editor in the Address & map box: search for the address, then drag the marker to the exact spot.

Listings without coordinates still appear in grid and rows views — they are simply absent from the map. Auditing this before launch is worth the five minutes.

What visitors can do

Price pins. Every listing is its own pin and shows its price at every zoom, so the market reads at a glance. Pins never fold into a numbered cluster — a count would hide the price. A listing without a price draws as a dot. The map holds up to 500 listings for one search and says so when a search reaches that cap.

Pin cards. Clicking a pin opens a card with the photo and its label chips — Featured, Open house and the like — the title, price, and beds and baths, with a Save to favorites heart and an Add to comparison button. The card links to the listing.

Save this search. The link under the map controls saves the current filters as a saved search.

Filters still apply. Everything from the filter bar narrows the map at the same time, and the map fits its bounds to the results.

Default center and zoom

New sites with no listings need a sensible starting position. The default center and zoom are set in code and can be changed from a child theme:

add_filter( 'astora_property_map_default_center', function () {
    return array( 41.0082, 28.9784 ); // lat, lng
} );

add_filter( 'estatepoint_property_map_default_zoom', function () {
    return 11;
} );

Once results exist the map fits to them, so this only matters for an empty or unfiltered first paint.

Homepage map hero

The Hero Map widget puts the same map at the top of the front page with a search bar over it. It is the strongest choice when your visitors think in neighborhoods rather than keywords, and the heaviest hero — pick it deliberately, not by default.

Performance

The map loads its dataset in a single request and caps how many markers it returns, so a site with thousands of listings stays responsive. Visitors narrow with filters rather than by rendering everything at once.

Troubleshooting

SymptomLikely cause
Map area is blank or greyTile requests blocked — check the browser console and any firewall or ad-blocking layer
Listings missing from the mapThose listings have no coordinates
Map view URL 404sPermalinks not flushed — Settings → Permalinks → Save Changes
Pins in the wrong placeThe marker was left on the geocoded guess instead of being dragged to the property
Map is squashed inside a tab or accordionIt was initialized while hidden; give the container an explicit height