MLS Import Documentation Aug 7, 2026 · 9 min read

The Design Settings page

B
Benjamin Levy
Contributor · MLSimport

The MLS Import Design Settings screen controls how your listings look on the front end: page sizes, colours, maps, the property page layout, the card style and the agent pages. It has nine tabs, and this page covers every setting on all of them.

The screen only exists in standalone mode. Changes are saved with the Save changes button at the bottom, and take effect immediately.

General

General tab of MLS Import Design Settings, from Property URL base to Search results page

Property URL base is the word your listing addresses sit under. The default listing gives yoursite.com/listing/. Change it only if another page or plugin already uses that word, because existing listing links break when you do.

Properties per page is how many listings a taxonomy or property archive page shows before paginating. The default is 12. Page builder blocks ignore this, because each block sets its own per page value.

Cards per row is 2, 3 or 4 across on those same archive pages, defaulting to 3. It drops to two and then one on narrow screens on its own, so there is no separate mobile setting.

Order by sets the default sort. Alongside the obvious price and newest options there are bedroom and bathroom sorts, and both a newest edited and an oldest edited option, which order by when the listing last changed rather than when it first arrived.

Show featured listings first puts the listings you mark as featured at the top of the default order, each with a Featured badge. It is on by default. When a visitor picks a sort, such as price, that sort wins. Set it to No and featured listings follow your normal order.

You mark a listing as featured on the property edit screen, with the Featured listing checkbox in the Other Details tab. For many listings at once, use the Mark featured bulk action in the Properties list.

Search results page is the page a Search Form block sends visitors to, usually the page that holds your listings grid or half map. A block with its own Results page URL ignores this setting.

Category page filters

Category page filters tab of MLS Import Design Settings, with the Archive search filters switches outlined

This single control decides which filters appear in the search bar on your taxonomy and property archive pages. Every searchable field is offered: a keyword box, all eleven taxonomies, price, beds and baths, living area, lot size, year built, listed after, garage spaces, stories, maximum HOA fee, maximum days on market, location, subdivision, MLS number and a sort control.

Out of the box only Status, City and Property Type are on. Turn on the filters you want, then click Save changes.

Property archive page with the search bar outlined, showing Property Type, Status and City

Remove the search bar from category pages

  1. Go to MLS Import Design Settings and open Category page filters.
  2. Turn off every filter under Archive search filters.
  3. Click Save changes.

Area, city, subdivision and other category pages then show the result count and their own listings, and so does the main property archive.

Property archive page with every Archive search filter off, showing the result count and listings with no search bar

This setting covers all category pages at once. To hide the search bar on a regular page, turn off Show filter bar on its block, as shown in the Property List block article.

Pro Tip

A filter that is on but always empty means the underlying field is not being imported. Check the field is ticked on the Select Import fields tab before assuming the filter is broken.

Social and Contact

Social and Contact tab of MLS Import Design Settings, with company details, form recipients and consent wording

Company name and Company phone are shown as the contact details on listings whose agent comes straight from the MLS feed. MLS rules generally forbid publishing the feed agent’s own phone and email, so your office details stand in.

Email is your company address. It is where a lead goes when the listing has no agent email of its own, so leaving it blank means those leads have nowhere to land.

Contact form recipients is where the page builder Contact Form block sends submissions. One or more addresses, comma separated. Left empty it falls back to the company email above.

Text for the checkbox label and Text for terms link are the consent wording next to the marketing checkbox on every form. The link text defaults to Privacy Policy. Writing this once here changes every form on the site.

Show ‘What are you looking to do?’ dropdown adds an intent dropdown to the contact forms, and Dropdown options is its comma separated choices, defaulting to Buy, Rent, Sell.

Maps

Maps tab of MLS Import Design Settings, with the address lookup URL, MapBox key, starting point, zoom and pin cluster settings

OpenStreetMap address lookup URL is the free Nominatim lookup used for Home Comparison reports. No API key is needed. Keep the default unless you run your own Nominatim server.

MapBox API KEY switches map tiles from the free OpenStreetMap servers to MapBox. Left blank the default server is used, which is noticeably slower under load.

Starting Point Latitude and Starting Point Longitude are a fallback centre, used only when a listings map has no results to show. When there are results the map zooms to fit them and these are ignored, which is why setting them does not move a working map.

Default Maps zoom (1 to 20) defaults to 11 and drives the single property map plus the fallback view. 1 is the whole world, 20 is street level.

Use the Pin Cluster on the maps groups nearby pins into a numbered bubble, and Maximum zoom level for cluster to appear is the cut over. Clusters show up to that zoom, and past it every listing gets its own price pin.

Property Page

This tab has six sub screens.

General

Property Page General sub screen of MLS Import Design Settings, with the Media Section Type choices

Media Section Type picks how the photos are presented: Classic Slider, Vertical Slider, Slider v4, Multi Image Slider, Masonry Gallery v1 or Masonry Gallery v2. Classic Slider is the default.

Property Page Layout

Property Page Layout sub screen of MLS Import Design Settings, with Details Columns and Arrange Sections

Details Columns runs each details section in 2 or 3 columns, defaulting to 3, and collapses on narrow screens.

Arrange Sections is the layout control for the whole page. Drag sections between Enabled and Disabled, and reorder them within a list. This is covered in full in the property page article.

MLS Attribution

MLS Attribution sub screen of MLS Import Design Settings, with the MLS logo and Extra Disclaimer

MLS logo is the attribution image your board requires. It shows in the attribution section and on listing cards.

Extra Disclaimer is the required legal text, written once and printed on every property. Two placeholders resolve per listing: %mls_id% becomes that listing’s MLS number and %year% becomes the current year. You can also use %agent_phone%, %agent_email%, %office_phone%, %office_email% and %attribution_contact%. Each stays empty unless that field is ticked under MLS Import Settings, Listing Details. Basic HTML including links and bold is allowed.

Tour Details

Tour Details sub screen of MLS Import Design Settings, with the Preferred tour times field

Preferred tour times is the comma separated slot list offered in the Schedule a Tour picker, for example 9:00 AM, 11:30 AM, 2:00 PM, 4:30 PM. Leave it blank and the time picker is hidden, which is why it ships empty.

Overview

Overview sub screen of MLS Import Design Settings, with Arrange Fields and the Enabled and Disabled lists

Arrange Fields chooses which tiles appear in the Overview strip near the top of a property page, and in what order. The tiles are Updated, Sub type, MLS number, Bedrooms, Bathrooms, Size, Year Built and Garage.

Similar Listings

Similar Listings sub screen of MLS Import Design Settings, with the number of listings and listings per row

Number of similar listings defaults to 3, and Similar listings per row is 2, 3 or 4 across.

Pro Tip

The disclaimer and the tour times both ship blank on purpose. The plugin cannot tell a field you cleared from a field you never touched, so a non blank default would print on every property with no way to switch it off.

Property Card

Property Card tab of MLS Import Design Settings, with Property card style and Badge over the photo

Property card style is a single choice that restyles every listing grid on the site at once: search results, lists, sliders, similar listings and agent pages. V1 is the standard card, V2 is horizontal with the photo on the left, V3 overlays the price and address on a full bleed photo.

Badge over the photo sets what the badge on listing cards and the property page says. MLS status shows the status the MLS sends, such as Active or Pending. Listing Type shows the listing’s Listing Type category with the name you gave it under MLS Properties, Listing Types, for example For Sale or For Rent.

Agent

Agent tab of MLS Import Design Settings, with listings per page, listings per row and Arrange Sections

No. of listings per page and No. of listings per row control the listings grid on a single agent profile, defaulting to 12 and 3.

Arrange Sections orders the agent profile’s content column, which holds About, Listings and Credentials. The hero at the top and the contact rail in the sidebar are fixed and not part of this control.

Saved Search tab of MLS Import Design Settings, with the save search switch and the email settings

Let visitors save a search adds a Save this search button to the Search Results block. Visitors who confirm by email get one email a day with the new and updated listings that match.

Max listings per email defaults to 12. When more listings match, the email links to the full results page.

Email subject and Email intro line set the wording of the daily email. {site_name} is replaced with your site name and {name} with the recipient name.

Email disclaimer is the MLS disclaimer printed at the bottom of the daily email, above the unsubscribe link. {year} is replaced with the current year and {site_name} with your site name. Basic HTML including links and bold is allowed.

Colors

Colors tab of MLS Import Design Settings, with the Main Color and Featured map pin color pickers

Main Color is one accent colour that re-tints the whole front end. Buttons, links, badges, the saved property hearts and the section highlights all derive from it, including their hover shades, so one pick is enough.

Featured map pin color is the background of Featured listing pins on the Map and Half Map blocks. Choose a dark color so the white price labels stay readable. Cluster bubbles keep their own color.

Frequently asked questions

Why does my archive page still show 12 listings after I changed the block?

Because they are separate settings. Properties per page governs the archive and taxonomy pages, and each page builder block carries its own per page value used on the page it sits on. Change the one that matches the page you are looking at.

I set a map starting point and the map still opens somewhere else.

That is expected. The starting point is only used when a map has no listings to show. With results the map always zooms to fit them, so the way to change what a map opens on is to change which listings it displays.

Can I set different card styles on different pages?

Not from the settings. The card style is site wide by design, so every grid stays consistent. A developer can override it per grid with the mlsimport_card_template filter.

Do these settings apply to my imported listings on a supported theme?

No. They only exist in standalone mode. On WpResidence, Houzez, Real Homes or WpEstate the theme owns the look of the property pages and its own options control it.

  1. Editing design settings in the Customizer
  2. Arranging the single property page
  3. Property card styles V1, V2 and V3
  4. Building your pages: blocks, shortcodes and Elementor widgets

Send us the setting you cannot get to take effect and we will check it against your site.

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