Overview
The Search widget (sometimes referred to as the 'advanced search form widget') displays a search form that provides access to nearly all the MLS criteria for your MLS. This widget is mobile- and container-responsive and will adjust for device sizes and fit into most spaces on a webpage.
Widget Type: data-type="SearchForm"
Key Features
- Provides access to nearly all MLS search criteria
- Container-responsive design optimized for all screen sizes
- Area search with City, Neighborhood, or Zip matching
- Search Nearby function using geolocation (HTTPS required)
- Expandable "More Filters" panel for advanced options
AVOID CONFLICTS: The Search Widget cannot be loaded on any page with another Search widget, a Quick Search widget, or a Results Widget.
Layout and Responsive Design
Container Responsive Design:
- Uses container queries for dynamic adaptation to any placement context
- Optimized for mobile display with support for containers as narrow as 280px
- Typical layout breakpoint occurs at 768px
- Ensures consistent user experience across all digital environments
Display Modes:
- Standard View: Compact search form with area search and property type selection
- Search Nearby: Geolocation-based search (requires HTTPS)
- More Filters: Expanded panel showing all advanced search options
Colors and Theming
- Widget Themes can be used to apply predefined or custom color schemes
- Background: Always transparent
Basic Implementation
<bb-widget data-type="SearchForm"></bb-widget>
[mbb_widget data-type="SearchForm"]
Use A Button or Link to Show The Search Form in a Popup
See the Widget Function method for creating a link or button that will show the full search form in a modal (popup) on the page.
Parameters and Filters
Required Parameters
data-type="SearchForm"
This defines the widget to be a Search Widget
Widget-Specific Filters
All filters are applied using data-filter="parameter:value" format. Multiple filters can be combined using the + symbol.
Important: For comprehensive information about general filter parameters and MLS criteria, see the Filter Parameters Reference.
data-filter="show-options:true"
To load the Search Widget with the More Filters panel immediately displayed
data-filter="login-panel:false"
Hides the horizontal bar above the Search Form that displays the My Account login panel with links for "Searches and Alerts, Favorite Properties, Recent Properties, Register, Login"
Search Filters
Applying a Filter to the Search Widget will pre-set search values. For example, to pre-set the price range on the search form to be 400k to 900k, or to limit searches to specific property types.
IDX Compliance: If you do preset search form values, you should put a header above the search form to clearly indicate what the form will show consumers (e.g., "Search for Residential Properties").
Implementation Examples
Code examples for common use cases
Grab and Go Widgets: For quick implementation, visit Widget > Grab-and-Go Widgets in your dashboard to find a large collection of ready-to-use widgets already configured for your account.
Basic Widget
<bb-widget data-type="SearchForm"></bb-widget>
[mbb_widget data-type="SearchForm"]
Pre-set Price Range
<bb-widget data-type="SearchForm" data-filter="price_min:400000+price_max:900000"></bb-widget>
[mbb_widget data-type="SearchForm" data-filter="price_min:400000+price_max:900000"]
Show More Filters Initially
<bb-widget data-type="SearchForm" data-filter="show-options:true"></bb-widget>
Hide Login Panel
<bb-widget data-type="SearchForm" data-filter="login-panel:false"></bb-widget>
Default Behavior
- Displays with the My Account login panel visible
- More Filters panel is collapsed by default
- Area search field allows searching for City, Neighborhood, or Zip
- Search Nearby function available if website uses HTTPS
Advanced Configuration
Lead Capture Integration
The Lead Capture settings in your Buying Buddy account Settings area will determine how many times the Search Widget can be used. You can limit the search criteria your website visitors can choose from before being required to register, or the number of times they can search before having to register.
Search Flow
- A search will go to your "results" page and show results using the Results Widget
- Clicking on "View Details" for a property will show property details.
Limitations
- Cannot be used on the same page as another Search widget, Quick Search widget, or Results widget
- Search Nearby function requires HTTPS
- Always searches for ACTIVE properties (regardless of sub status)
- No support for searching by sub status (e.g., backup offers)