The Property List block

The Property List block is a grid of listings with a search bar above it and pagination below. Visitors narrow the results in place without the page reloading, which makes it the block to use for a category landing page or a general listings page.

You set an initial filter on the block, and the search bar refines within it. A block filtered to Miami never shows anything outside Miami, whatever the visitor types.

What you can set

Per page is the page size, defaulting to 12. The pager handles the rest, so there is no separate total limit.

Show filter bar hides the search bar and leaves a plain grid, useful when the page already has a Search Form block of its own.

Search fields is a comma list of which filters the bar offers, and Search fields per row lays them out 3, 4, 5 or 6 across, defaulting to 4. Leaving the field list empty offers all of them.

The initial filter covers every searchable value: 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, sort order and agent.

As a shortcode

[mlsimport_item_list city="Miami" property_type="Condominium" status="Active" count="12"]

Every option is an attribute of the same name. Multi value filters take comma lists, so status="Active,Pending" matches either.

In the block editor

Add the Property List block, grouped with the other MLSImport blocks in the inserter. The initial filter, the page size and the search bar options are in the sidebar inspector, and the grid renders with your live data as you edit.

In Elementor

Drag Property List from the MLSImport Widgets group. The filter and layout options are on the Content tab. The Style tab adds typography, colour, spacing and border controls for the card price, title and specification line, including the title hover colour.

If it does not work

1. The block shows nothing. No listing matches the initial filter. Clear the filter fields one at a time to find which one is empty. Value spelling has to match the MLS exactly, so Condo does not match a feed that publishes Condominium.
2. The search bar has fields that never return anything. Those fields are not being imported. Tick them on the Select Import fields tab and run the import task again.
3. Results appear but paging does nothing. A caching plugin is serving the same page for every page number. Exclude the listings page from the cache or exclude the query parameters it uses.
4. The grid ignores my cards per row setting. That setting applies to archive pages. Grid width on a page block comes from the column width you give it in the builder.

Frequently asked questions

What is the difference between this and the Search Results block?

Where the starting filter comes from. Property List takes it from the options you set on the block. Search Results takes it from the search a visitor submitted, so it belongs on the page your search form points at.

Can I put two Property List blocks on one page?

Yes, and it is a common layout, for example new listings above reduced listings. Each keeps its own filter and its own pager.

Can I show only one agent’s listings?

Yes. The Agent option takes an agent profile ID and limits the grid to listings linked to that agent. It matches the agent posts you created, not the listing agent named in the MLS feed.

Does the block obey the site wide sort setting?

Only until you set one on the block. The Order by design setting is the site default, and a sort chosen on the block or by the visitor in the search bar overrides it for that grid.

Related

1. Building your pages: blocks, shortcodes and Elementor widgets
2. The Search Results block
3. The Search Form block
4. The Half Map block

Send us the page and the filter you set and we will tell you why the grid is empty.