Search Widget

The Search widget should be placed on a "search" page in your website so that you can test your foundation page setup.

The Search widget displays a standard search form that provides access to nearly all the MLS criteria for your MLS.

The Search Widget cannot be loaded on any page with:
- another Search widget
- a Quick Search widget
- a Results Widget

Key Features

This field provides a search and select function. It will find matches for City, Neighborhood or Zip. For some MLS, this may also include Area or Region.

Search Nearby (enabled if your website uses HTTPS)

Clicking the navigation arrow button at the start of the form, will replace the Area search with the 'Search Nearby' function.

More Filters

The More Filters panel will show all the advanced search options.

This widget is mobile responsive and will expand to fill any container / space made available in your website page design.

You can add the search form widget to any number of pages.


  • Minimum width: Designed for mobile
  • Maximum width: Unlimited

Colors and Background

  • Widget Themes can be used to apply predefined, or your own, color schemes.
  • Background is always transparent.


1. id='MBBv3_SearchForm' (required)

This defines the widget to be a Search Widget

[label color="success"]Examples[/label]

The Search Widget can be displayed using the following widget code:

The default :

<div id="MBBv3_SearchForm"></div>

If you are using the WordPress MBB Plugin, then the short code is like this:

[mbb_widget id="MBBv3_SearchForm"]

2. Pre-set Search Values using filter=".."

Applying a Filter to the Search Widget (as part of the widget / shortcode) will pre-set search values.

For example, your MLS may have "residential" properties as one or more property types, but rather than hope that consumers find those values in the search fields, you want to pre-set these.
So, to achieve this, add the appropriate filter to the search widget. Read about Filters

Don't forget, for IDX rules compliance, IF YOU DO preset search form values, you probably should put a header above the search form to say "Search for Residential Properties" so it's clear to the consumer what the form will show them.

NOTE Any filter specified in the page URL will replace and override the filter set on the widget. Therefore, we suggest that you send custom search links to your general purpose 'results' page

For example, to pre-set the price range on the search form to be 400k to 900k:

<div id="MBBv3_SearchForm" filter="price_min:400000+price_max:900000"></div>
[mbb_widget id="MBBv3_SearchForm" filter="price_min:400000+price_max:900000"]

3. Show the "More Filters" panel when Widget Loads"

To load the Search Widget with the More Filters panel immediately being displayed, use this filter.

  • filter="show-options:true"

For example:

<div id="MBBv3_SearchForm" filter="show-options:true"></div>
[mbb_widget id="MBBv3_SearchForm" filter="show-options:true"]

4. Hide the "My Account" Options (login etc) bar

The horizontal bar above the Search Form displays the My Account login panel with links for "Searches and Alerts, Favorite Properties, Recent Properties, Register, Login"
This bar is presented by default.
If you wish, you can hide this using the following filter option:

  • filter="login-panel:false"

For example:

<div id="MBBv3_SearchForm" filter="login-panel:false"></div>
[mbb_widget id="MBBv3_SearchForm" filter="login-panel:false"]

Notes on Searching

The Buying Buddy Search methods always search for ACTIVE (regardless of sub status). There is no support for searching by sub status.
(i.e. you cannot search for properties that are active / backup).

The results set will include all properties that have a main status of ACTIVE regardless of sub status

NOTE: SOLD and UNDER CONTRACT status can be displayed (if the data is available in your MLS IDX feed)  by using Display Widgets with an appropriate filter

Lead Capture Settings

The Lead Capture settings in your Buying Buddy account Settings area will determine how many times the Search Widget can be used.
If you would like to limit the search criteria your website visitors can choose from before being required to register, or the number of times that can search before having to register, see Customize Lead Capture Settings.


Below is a visual example of a search sequence on your website:

  • A Search will go to your "results" page and show results using the Results Widget.
  • Clicking on "View Details" for a property will go to your "details" page and show property details using the Property Details Widget
Updated on November 19, 2022

Was this article helpful?

Related Articles

Need Support?
Can't find the answer you're looking for?
Contact Support