MLS Import Documentation Aug 7, 2026 · 4 min read

Building your pages: blocks, shortcodes and Elementor widgets

The thirteen standalone page blocks, and how to place each one as a shortcode, a Gutenberg block or an Elementor widget.

B
Benjamin Levy
Contributor · MLSimport

Standalone mode ships thirteen page blocks: property grids, sliders, maps, search forms, category tiles, a team directory and a contact form. Each one is available in three places, as a shortcode, as a Gutenberg block and as an Elementor widget, and all three produce identical output.

Pick whichever surface matches how you build pages. There is no feature difference between them.

Before you start

Standalone mode has to be active, and you need at least a few imported properties. Most blocks render nothing at all when there is nothing to show, which looks like a broken block on an empty site.

The thirteen blocks

  1. Property List, a filterable grid with a search bar and pagination.
  2. Search Results, the results page a search form submits to.
  3. Search Form, a standalone search bar you place anywhere.
  4. Half Map, listings beside a live map.
  5. Map with Listings, a map on its own.
  6. Property Slider, a swipeable carousel of listings.
  7. Featured Property, one listing in a large format, in six designs.
  8. List Properties by ID, an explicit hand picked set.
  9. Saved Properties, each visitor’s own saved list.
  10. Category Slider, taxonomy terms as sliding image tiles.
  11. Display Categories, the same tiles as a static grid.
  12. Team Directory, your agent profiles as cards.
  13. Contact Form, a configurable lead form.

Using them as shortcodes

Every block has a shortcode named after it, and every option is an attribute. The shortcode works in any editor, in a widget, and in a template through do_shortcode().

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

Options you leave out fall back to their defaults, so a bare [mlsimport_item_list] is valid and shows everything.

Using them in the block editor

The blocks sit in their own category in the inserter, grouped under the MLSImport real estate heading. Search the inserter for the block name, drop it in, and the options appear in the sidebar inspector on the right.

Each block renders on the server, so what you see in the editor is what the visitor gets, drawn with your live data rather than a placeholder.

Using them in Elementor

The widgets appear under MLSImport Widgets, pinned to the top of the widget panel. Drag one in and its options are on the Content tab.

The listing, agent and form widgets also carry a Style tab with typography, colour, spacing and border controls for the card elements, which the shortcode and Gutenberg versions do not have. That is the one real reason to prefer Elementor for these.

Pro Tip

All three surfaces call the same rendering code, so a page built with shortcodes and a page built in Elementor produce the same markup and read the same design settings. Mixing them on one site causes no inconsistency.

What the design settings control instead

Blocks decide what to show and how many. Look and feel comes from MLS Import Design Settings: the card style, the brand colour, the map defaults and the property page layout apply everywhere at once.

Two settings deliberately do not reach the blocks. Properties per page and Cards per row apply to the archive pages only, because each block carries its own per page and per row option.

The original listings shortcode

There is also a plain [mlsimport_listings] shortcode that predates the page blocks. It accepts the same filter attributes and renders the same grid.

[mlsimport_listings city="Austin" price_min="200000" beds="3" limit="12"]

Existing pages using it keep working. For new pages, Property List is the same grid with a search bar, pagination and editor controls.

Pro Tip

Multi value attributes take comma lists, on the shortcode and in the block inspectors alike. status="Active,Pending" matches either, and features="private-pool,has-waterfront" requires both, because amenities narrow a search rather than widen it.

Frequently asked questions

Can I use these blocks on a site that is not in standalone mode?

No. They read the standalone property post type and its search index, neither of which is written when the plugin is set to one of the four supported themes. On those themes the theme’s own widgets do this job.

My block shows nothing on the page. What is wrong?

A block that matches no listings renders nothing rather than an empty frame. Check the filter you set on it, then check that properties exist and are published. The category tiles are the other common case, since they show only the terms you explicitly pick.

Do these blocks work with page builders other than Elementor?

Any builder that accepts a shortcode can use every block, which covers most of them. Only Gutenberg and Elementor have native controls.

Will my pages break if I switch page builder later?

Shortcodes survive any switch. Gutenberg blocks and Elementor widgets are stored in their builder’s own format, so moving between the two means rebuilding those pages, exactly as it would for any other block.

  1. Standalone mode: run MLSImport on any theme
  2. The Design Settings page
  3. The Property List block
  4. Elementor PRO compatibility

Send us the page you are building and we will tell you which block arrangement gets you there.

B
About the author
Benjamin Levy
Writes about MLS feeds, IDX compliance, and running real-estate websites on WordPress at scale.
All posts by Benjamin