Overview
The Results widget serves two key purposes:
- As your main search results display on your designated Results Foundation Page
- As a filtered property display on additional pages throughout your site
Dual Functionality Explained
Primary Function: Search Results Foundation Page
Your website requires one designated Results Foundation Page containing the Results widget with no filters. This page:
- Serves as the destination for all property searches
- Must contain an unfiltered version of the Results widget
- Functions as the core of your Buying Buddy system
Secondary Function: Filtered Property Display
You can also use the Results widget on other pages to showcase specific property types by:
- Adding the widget to additional pages
- Applying filters to display only certain properties
- Creating targeted landing pages for visitors
Creating Filtered Property Pages
Follow these steps to create specialized property displays:
- Create a new page in your website
- Add the Results widget to this page
- Apply filters to show only specific properties
- Link to this page from your navigation menu or content
Important Considerations
Foundation Page Requirements
Your designated Results Foundation Page must:
- Contain the Results widget with NO filters applied
- Serve as your primary search results destination
- Remain unmodified to ensure proper system function
SEO Limitations
The Results widget does not provide SEO benefits because:
- It loads property data via JavaScript after page load
- Search engines cannot index the dynamically loaded content
- For SEO benefits, use "Featured List" or "Featured Gallery" widgets instead
Technical Restrictions
- One per page only: The Results widget includes a map and can only appear once per page
- Any other map-using widgets will conflict with it
How Filters Work
Important: Setting a height will remove sticky map positioning.
If the inline style includes any height-related property (height, max-height, min-height), the widget will no longer use sticky positioning. The widget will instead be constrained to the specified height with internal scrolling.
Filter Behavior
When using a filtered Results widget:
- Initial load: Shows properties matching your preset filter
- User interaction: Allows visitors to modify search criteria
- New searches: Replace your preset filter with user's choices
- Page reload: Preserves user's most recent search criteria
Reset Function
- Clicking "Reset Form" clears ALL search fields
- This does NOT reapply your original filter
- Users must refresh the page to see your original filtered results
Adding Filters to the Widget
Use the filter parameter to specify which properties to display:
<bb-widget data-type="ListingResults" data-filter="city:denver+price_min:200000"></bb-widget>
or
[mbb_widget data-type="ListingResults" data-filter="city:denver+price_min:200000"]
Example Filters
- Show only Denver properties:
data-filter="city:denver" - Properties $200k and up:
data-filter="price_min:200000" - Combine criteria:
data-filter="city:denver+price_min:200000+beds_min:3"
Additional Resources
- See the Results widget reference page for details on Variants, Dimensions and Parameters
- Consult "Search Filters" and "How to Use Search Filters" guides for more filter options