Use one or more widgets to create a display of your own properties on a web page.
NOTE: If you wish to display your own non- MLS listings (pocket or private) then see Displaying Non MLS Listings
See the How To Display Properties article for a full explanation of how to use the Wizard and Widgets.
This article will look specifically at how to display your own listings.
IMPORTANT. Make sure that your MLS Agent ID is added to your Personal Profile in your Buying Buddy account.
Your MLS Agent ID is shown with your listings and identifies you as the "Listing Agent".
If you are not sure what this is, use the Listing Lookup Tool.
1. Create a Web Page on your website
If you don't already have a page for this, then add a page that will display your listings. You may also want to ensure there is navigation on your website to direct visitors to this page.
2. Use the Wizard to Create a Widget to Display Properties
Follow the steps in the Wizard to create the widget you need.
When you are displaying a curated set of listings, you can use the Grid Layout, Carousel, List or Map.
- The List Display widget shows all your listings. This is a good widget to use if you have or wish to show a lot of listings as pagination is built in.
- The Grid/Gallery Display widget is good for showcasing a fixed number number of properties (e.g. 4).
- The Grid/Gallery widget has an alternative "featured-grid" layout that can be used when displaying only your own, or your brokers listings.
- The Carousel will display a single row of animated listings.
- The Map Display widget will show properties as pins on a map.
Example List Display Widget:
<div id="MBBv3_FeaturedList" ></div>
[mbb_widget id="MBBv3_FeaturedList"]
3. Display Your Listings
Display widgets that have NO FILTER will display your account's Default Listings.
Generally, this will be based on your MLS Agent ID or MLS Office ID, which means that with no additional parameters, a display widget will typically show your properties.
IMPORTANT: If no listings are shown then check your Profile in the Buying Buddy dashboard to ensure you have added your MLS Agent ID correctly.
4. Display "Featured" Listings Using A Filter
Using a filter will allow you to precisely control what gets displayed - and this is the recommended approach.
Use the Wizard to define the exact listings you want to present based on MLS search parameters as well as MLS Office ID and MLS Agent IDs.
Hide Your Featured Properties section if there are no listings to display
It is possible to completely hide the section on your web page that shows your featured listings - including any heading such as "Here are my featured Listings" - in the case where you have no listings.
Use the nolistingshide filter parameter.
This option is an advanced option and will need to be manually added to any filter you have created.
You can find instructions for how to use this option in the widget references for List Display and Gallery Display.
Examples
Make sure you specify the correct MLS Agent and MLS Office IDs. If in doubt, go to Listings > Listing Lookup Tool, where you can enter the MLS# of a property and see all the Agent and Office IDs we receive from the MLS.
Show Listings From "My" Office
In this case, use a filter and specify filter="office_id:XXXX" (replace XXXX with YOUR office ID!)
<div id='MBBv3_FeaturedList' filter='office_id:XXXX'></div>
[mbb_widget id='MBBv3_FeaturedList' filter='office_id:XXXX']
Show all the office listings but sort so that "my" listings are always shown first.
In this case, set the filter to use the office_id again, but now add the order parameter to your filter as follows, using your MLS Agent ID (replace 123456 with YOUR agent ID!)
- show all listings in the office - office_id:XXXX
- Sort to always show Agents listings first - order:FIELD(agent_id,'123456') desc (notice agent ID is in single quotes)
- Then add a second level for the remaining listings by listing date - create_dt desc
<div id='MBBv3_FeaturedList' filter="office_id:XXXX+order:FIELD(agent_id,'123456') desc, create_dt desc"></div>
[mbb_widget id='MBBv3_FeaturedList' filter="office_id:XXXX+order:FIELD(agent_id,'123456') desc, create_dt desc"]
Show my listings and listings from another agent too.
In this case, use a filter and specify filter="agent_id:YYYY,ZZZZ", where YYYY and ZZZZ are both your MLS Agent IDs.
<div id='MBBv3_FeaturedList' filter='agent_id:YYYY,ZZZZ'></div>
[mbb_widget id='MBBv3_FeaturedList' filter='agent_id:YYYY,ZZZZ']
Show SOLD
In this case, use any of the examples above, but in this case specify "listing_status:sold" in the filter:
<div id='MBBv3_FeaturedList' filter='listing_status:sold'></div>
[mbb_widget id='MBBv3_FeaturedList' filter='listing_status:sold']