This guide will walk you through installing and setting up Buying Buddy on your HubSpot website. The process involves three main steps that we'll cover in detail.
Important: Make sure you have set your website type as a "HubSpot" site in . This ensures you see the correct install code for your HubSpot website.
Staging Domain Authorization: When working in the HubSpot development area, your site may display using a HubSpot subdomain like "http://xxxxxxx.hs-sites.com". If you see "Sorry this domain is not authorized", the widgets are working correctly but need this domain added to your account. Contact support to add your staging domain as an authorized domain.
Installation Steps
1
Add Buying Buddy Plugin to Your Site
Install the JavaScript library site-wide
Get Your Plugin Code:
- In your Buying Buddy dashboard go to Installation and Setup
- Select your website and ensure it's set as a HubSpot site on the "Get Ready" tab
- Go to the "Add Plugin" tab and copy the JavaScript code
Install the Plugin:
- In HubSpot top menu, go to Marketing > Website > Website Pages
- In the top black bar on the right, click the cog icon to go to the Settings panel for your website
- Scroll down the left menu and click Website > Pages
- Below the Pages heading, choose the domain you are working on or use "Default Settings for All Domains"
- Go to the Tab section and select Templates
- Paste the Buying Buddy JavaScript code in the Site Header HTML section and click SAVE
Critical: The plugin JavaScript should only be added ONCE using the method above. Do not modify the code.
Add the Disclaimer Widget (Recommended):
While in the Templates section, add the disclaimer widget to the Site Footer HTML to keep your pages clean:
<bb-widget data-type="Disclaimer"></bb-widget>
This displays required MLS disclaimers in your footer instead of under each widget. You can customize colors using the Widget Wizard.
2
Create Foundation Pages
Set up the four required Buying Buddy pages
Important: Buying Buddy uses four Foundation Pages. Three of them are Utility Pages (Results, Property Details and Market Report) that should NOT be added to your menus - their content is generated dynamically when a visitor runs a search, views a property, or opens a market report. The fourth is a Feature Page (Community Hub), which displays your default Community group and CAN be added to a menu if you wish. Add only one Buying Buddy widget to each page, and make sure all four page addresses match your Buying Buddy account settings.
Create the Pages:
- Results Page (not in menu)
- Property Details Page (not in menu)
- Market Report Page (not in menu)
- Community Hub Page (can be in a menu if desired)
- Create four BLANK PAGES with appropriate titles like "Results", "Details", "Market Report" and "Community Hub"
- To match the default slugs, use "/listing-results", "/listing-details", "/market-area-report" and "/featured-communities" (these slugs can be anything you like as long as they match the Foundation Page settings)
- The Results, Details and Market Report pages should NOT be added to your Main Navigation Menu. The Community Hub page CAN be added to a menu if you wish.
Add Widgets to Pages:
Remember: In HubSpot, Buying Buddy widgets need to be added to a "Rich Text" module. Also, widgets fill available space, so adjust the Section on the page for full width layout.
For the Results page:
- Edit your "Results" page
- From the Edit page options, click and drag a Rich Text module to the page Section
- In Edit mode, click Advanced > Source Code to show the Source Code editor
- Paste the following code for the Results widget:
<bb-widget data-type="ListingResults"></bb-widget>
- Save your page
- Preview the page to verify the widget displays correctly
For the Details page:
- Repeat the above steps for your "Details" page
- Use this widget code instead:
<bb-widget data-type="SearchDetails"></bb-widget>
For the Market Report page:
- Repeat the above steps for your "Market Report" page
- Use this widget code instead:
<bb-widget data-type="MarketReport"></bb-widget>
For the Community Hub page:
- Repeat the above steps for your "Community Hub" page
- Use this widget code instead:
<bb-widget data-type="Communities"></bb-widget>
Add a Search Form (for testing):
Create a search form on any other page (not on your Results, Details, Market Report or Community Hub pages) using:
<bb-widget data-type="SearchForm"></bb-widget>
Confirm Foundation Page Settings:
- Return to your Buying Buddy dashboard
- Go to and click the "Foundation Pages" tab
- Verify page addresses match your URL slugs:
- Results: /listing-results
- Details: /listing-details
- Market Report: /market-area-report
- Community Hub: /featured-communities - Update if needed to match your actual page slugs
3
Enable Property Sharing
Set up social media sharing with correct listing photos
To allow visitors to share properties from your website on Facebook and other social media platforms with the correct listing photos and details, you'll need to set up a "bb" subdomain for your domain.
Setup Options: You can use either Cloudflare (recommended for free SSL certificates) or your current domain registrar.
The Social Media Sharing Setup Instructions will guide you through both options.
Next Step:
Note: Your Buying Buddy dashboard has customized instructions for your domain in the Installation and Setup section (Social Share Settings tab) of your Buying Buddy account.Widgets - Installation and Setup : Social Share tab
Troubleshooting
Staging Domain Authorization
If you see "Sorry this domain is not authorized", the widgets and Plugin JavaScript are working correctly, but your page address is using a domain not authorized to display Buying Buddy widgets.
There are two options:
- Ensure your actual domain name is applied and working, then view the live site
- For extensive development, contact Help Desk to add your HubSpot staging domain as a temporary authorized domain
Next Steps
You can now use HubSpot to create custom search forms and use all the capabilities of Buying Buddy widgets. Consider adding:
- Featured Listings pages to display your own listings
- Sold properties displays
- Neighborhood-specific property pages
- Lead capture forms connected to Buying Buddy CRM
- Contact forms and custom styling with Widget Themes
For inspiration, view our demonstration sites:
- https://charliesmithrealty.com (WordPress)
- https://charliesmithrealty.net (HTML / PHP)
Need additional help? Contact our support team through your Buying Buddy dashboard.