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 required Results and Details pages
Important: Create 2 live pages that should NOT be in your menus (they are reserved for use by Buying Buddy). Add the correct widget to each page (only one widget per page), and ensure page addresses match your Buying Buddy account settings.
Create the Pages:
- Create two BLANK PAGES with appropriate titles like "Results" and "Details"
- To match the default slugs, use "/listing-results" and "/listing-details"
- These pages should NOT be added to your Main Navigation Menu
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>
Add a Search Form (for testing):
Create a search form on any other page (not on Results or Details pages) using:
<bb-widget data-type="SearchForm"></bb-widget>
Confirm Foundation Page Settings:
- Return to your Buying Buddy dashboard
- Go to
- Verify page addresses match your URL slugs:
- Results: /listing-results
- Details: /listing-details - 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
SQL Error on Details Page
If you see this message, it's because you're attempting to view the Property Details widget on a page without a reference to a property. Ignore this - the widget is installed correctly and this error is never seen by users.
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.