This guide will walk you through installing and setting up Buying Buddy on your Duda website. The process involves four main steps that we'll cover in detail.
Important Notes Before You Begin
Website Type: Make sure you have set your website type as "Duda" in . This ensures you see the correct install code for your Duda website.
Domain Authorization: Buying Buddy widgets only load on authorized domains. When domains aren't listed in your account, you'll see a loading icon or "Sorry this domain is not authorized" message. Duda uses multiple domains for development and previews - contact support to have these added if needed.
Development Domains: When editing you may see domains like https://my.duda.co/home/site/{site-id} or preview domains like https://preview.duda.com/preview/{site-id}. These can be added as staging domains for development purposes.
Installation Steps
1
Add Buying Buddy Plugin to Your Site
Install the JavaScript library site-wide
Critical: The plugin JavaScript should only be added ONCE using the HEAD HTML section in SEO & Settings. Never add it to individual pages.
Get Your Plugin Code:
- In your Buying Buddy dashboard, go to Installation and Setup
- Select your website and ensure it's set as a Duda site on the "Get Ready" tab
- Go to the "Add Plugin" tab and copy the JavaScript code
Install the Plugin:
- In your Duda editor, go to SEO & Settings → HEAD HTML
- Look for the "HEAD HTML" section (NOT the "Body end HTML" section)
- Paste the Buying Buddy JavaScript code into the HEAD HTML field
- Click SAVE (you can safely ignore any warning messages about script loading - this code needs to be in the HEAD section to work properly)
Add the Disclaimer Widget (Recommended):
Add the disclaimer widget to your Global Footer to keep your pages clean. This displays required MLS disclaimers in your footer instead of under each widget.
- In your Duda editor, go to the Global Footer section
- Add an HTML widget block
- Paste this code:
<bb-widget data-type="Disclaimer"></bb-widget>
You can customize colors using the Widget Wizard to blend with your footer design.
2
Create Foundation Pages
Set up required Results and Details pages
Important: Create 2 pages that are hidden from navigation, 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:
- In your Duda editor, create two new Empty pages
- Give them appropriate titles: "Results" and "Details"
- For each page, click the cog icon and configure:
- Set Page URLs to /listing-results and /listing-details
- Select Hide In Navigation > Hide on all so pages don't appear in menus
Add Widgets to Pages:
Tip: The Results and Details widgets look best when placed in a full-width container. Consider using "full bleed" row settings for optimal display.
For the Results page:
- Edit your "Results" page
- Add an HTML widget to a single-column row
- Paste this code:
<bb-widget data-type="ListingResults"></bb-widget>
For the Details page:
- Edit your "Details" page
- Add an HTML widget to a single-column row
- Paste this code:
<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
Note: For Duda Editor and Preview domains, include the entire folder/page address,
e.g. /home/site/412dec21/listing-results and /home/site/412dec21/listing-details
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
Domain Authorization Issues
If you see "Sorry this domain is not authorized":
- For live sites: Ensure your actual domain name is applied and working, then view the live site
- For development: Contact support via the Help Desk to temporarily add your Duda staging domain as a free authorized domain
SQL Error on Details Page
If you see "SQL Error" on the Details page, this is normal when viewing the widget without a property reference. The widget is installed correctly - this error only appears during testing and is never seen by visitors.
Next Steps
Your Duda site is now ready for advanced Buying Buddy features! Consider adding:
- Featured Listings pages for your properties
- Sold properties displays
- Neighborhood-specific property pages
- Lead capture forms connected to Buying Buddy CRM
- Contact forms
- 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.