Results Widget as a Display Widget

Overview

The Results widget serves two key purposes:

  1. As your main search results display on your designated Results Foundation Page
  2. 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:

  1. Create a new page in your website
  2. Add the Results widget to this page
  3. Apply filters to show only specific properties
  4. 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

Filter Behavior

When using a filtered Results widget:

  1. Initial load: Shows properties matching your preset filter
  2. User interaction: Allows visitors to modify search criteria
  3. New searches: Replace your preset filter with user's choices
  4. 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:

[mbb_widget id="MBBv3_ListingResults" filter="city:denver+price_min:200000"]

or

<div id="MBBv3_ListingResults" filter="city:denver+price_min:200000"></div>

Example Filters

  • Show only Denver properties: filter="city:denver"
  • Properties $200k and up: filter="price_min:200000"
  • Combine criteria: 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

Updated on April 30, 2025
Was this article helpful?

Related Articles

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