The Map with Listings block is a map on its own, plotting every listing that matches the filter you set on it. There is no list beside it and no search bar above it, which makes it the block for a location page, a neighbourhood page or a home page section.
A map plots everything it matches at once. That is why it carries no page size and no sort order: pins have no sequence and no page two.
What you can set
Only the filter. City, state, ZIP, area, county, high school district, status, property type, listing type, label, features, keywords, price range, beds, baths, living area, lot size, year built, garage, stories, maximum HOA fee, maximum days on market, subdivision, listed after, and agent.
The filter fields use the same term pickers as the other blocks, so you choose from your actual cities and property types rather than typing them.
How it opens
The map fits itself to the listings it found, so it opens showing all of them and nothing more. This is why the starting point and zoom in the Maps design settings appear to be ignored: they are the fallback for a map with no results.
Pins carry the price. Nearby pins group into numbered clusters until the visitor zooms past the cut over level, both of which are set in the Maps design settings.
A map filtered to a single city still opens at whatever zoom fits that city’s listings, so a scattered rural county and a dense downtown look nothing alike. If the framing matters, narrow the filter rather than reaching for a zoom setting that will not apply.
As a shortcode
[mlsimport_map_listings city="Austin" status="Active" property_type="Single Family Residence"]
In the block editor and Elementor
In the block editor, add Map with Listings from the MLSImport group. Its filter controls are in the sidebar inspector.
In Elementor, drag Map with Listings from MLSImport Widgets. The filter controls are on the Content tab, with the same searchable term pickers.
Giving it a height
The block fills the container it is placed in. In Elementor set the section or column height; in the block editor put it inside a group or cover block with a height. A map in a container with no height collapses to nothing, which is the most common reason it looks missing.
Add a MapBox key in the Maps design settings before putting a map on a busy page. Without one the tiles come from the free OpenStreetMap servers, which throttle under load and leave visitors staring at grey squares.
If it does not work
- Nothing renders at all. No listing matched the filter, so the block outputs nothing rather than an empty map. Loosen the filter.
- Fewer pins than listings. Only listings with coordinates can be plotted. Some feeds withhold coordinates on certain listings, and nothing on the WordPress side can invent them.
- The map is grey. Tiles are not loading. Add a MapBox key, then check the browser console for a blocked request.
- The map has no height. Set a height on its container, since the block itself does not impose one.
Frequently asked questions
Can visitors search from this map?
No. It has no search bar and no draw tool. Use the Half Map block when the map needs to be interactive in that way.
Can I plot a hand picked set of listings?
Not from the editor. Reproduce the set with a filter instead, or use the Label taxonomy: tag the listings you want with a label, then filter the map to it. Labels are never touched by the import, so the selection holds.
Do pins link to the property?
Yes. Clicking a pin opens the listing’s details and links through to its property page.
Why does the same block show different pins on different days?
Because it is a live filter, not a fixed set. Listings that go off market leave the map on the next reconciliation pass, and new matches appear as they are imported.
Related
- The Half Map block
- The Design Settings page
- The Property List block
- Building your pages: blocks, shortcodes and Elementor widgets
Send us the page and the filter and we will check how many of those listings carry coordinates.