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
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
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.
Remove the search bar from category pages
- Go to MLS Import Design Settings and open Category page filters.
- Turn off every filter under Archive search filters.
- 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.
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.
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
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
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
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
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 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
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
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
Number of similar listings defaults to 3, and Similar listings per row is 2, 3 or 4 across.
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 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
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
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
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.
Related
- Editing design settings in the Customizer
- Arranging the single property page
- Property card styles V1, V2 and V3
- 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.















