The Communities widget powers your Community Hub page and dynamically generates unlimited neighborhood marketing pages from a single widget installation. This widget works in conjunction with the Community Page Builder in your dashboard to display community pages, group index pages, and individual neighborhood marketing pages—all from one foundation page.
Widget Type: data-type="Community"
Foundation Page: This is a foundation widget that should be placed on your designated Community Hub page. To configure this foundation page in your Buying Buddy dashboard:
Key Features
- Powers unlimited community pages from a single widget installation
- Container-responsive design optimized for all screen sizes
- Automatic URL routing for community pages, group pages, and individual pages
- Displays MLS listings based on Community Page Builder criteria
- Integrates with AI-generated marketing content
- Supports multiple display layouts for group indexes
- SEO-optimized page structure and URLs
Layout and Responsive Design
Container Responsive Design:
- Uses container queries for dynamic adaptation to any placement context
- Optimized for mobile display with support for containers as narrow as 280px
- Typical layout breakpoint occurs at 768px
- Ensures consistent user experience across all digital environments
Display Modes:
- Hub View: Main community hub showing the default group's community pages
- Group Index View: Category landing page displaying all communities within a group
- Community Page View: Individual neighborhood page with listings and AI-generated content
Colors and Theming
- Widget Themes can be used to apply predefined or custom color schemes
- Background: Uses "Widget Background" color from the applied widget theme
Basic Implementation
Grab and Go Widgets: For quick implementation, visit in your dashboard to find ready-to-use widgets already configured for your account.
<bb-widget data-type="Community"></bb-widget>
[mbb_widget data-type="Community"]
Parameters and Filters
Required Parameters
| Parameter | data-type="Community" |
| Purpose | Defines the widget as a Communities Widget |
Widget-Specific Filters
The Communities Widget does not use data-filter parameters. All configuration is managed through the Community Page Builder interface in your Buying Buddy dashboard.
Important: Community pages, group pages, and display settings are all configured via in your dashboard—not through widget parameters.
URL Structure
The Communities Widget automatically handles URL routing to display the appropriate content based on the URL path:
| Hub Page | /communities |
| Group Index | /communities/group-name |
| Community Page | /communities/group-name/community-name |
Example URLs:
/communities - Hub page (shows default group) /communities/waterfront-properties - Group index page /communities/waterfront-properties/coral-gables - Individual community page /communities/luxury-homes/downtown-condos - Individual community page
How It Works
The Communities Widget operates differently from other Buying Buddy widgets. Instead of using filter parameters to define what content to display, the widget reads the URL path and displays content based on what you've configured in the Community Page Builder.
Single Widget, Unlimited Pages
- Install Once: Add the Communities Widget to a single "hub" page on your website
- Create in Dashboard: Use the Community Page Builder to create community pages with specific MLS criteria
- Automatic Display: The widget automatically displays the correct content based on the URL
- AI Content: Marketing content is generated automatically in the background
Group Pages
Group Pages organize your community pages into categories and are required for the URL structure to work properly. Each community page must be assigned to at least one group.
- Required Assignment: Every community page must belong to at least one group
- Multiple Groups: A community page can appear in multiple groups for cross-category visibility
- Default Group: One group serves as the featured category shown on your main hub page
- Display Options: Groups can display communities as photo grids, alphabetical lists, or link lists
Community Hub Setup
1
Create the Hub Page
One-time website setup
Create a new page on your website to serve as your Community Hub. Common names include "Communities," "Neighborhoods," or "Areas."
Steps:
- Create a new page in your website (e.g., "/communities")
- Add an H1 title to the page (e.g., "Communities" or "Neighborhoods")
- Add the Communities Widget code to the page
- Publish the page
2
Configure Foundation Page Settings
Connect your page to Buying Buddy
Tell Buying Buddy where your Community Hub page is located.
Steps:
- Navigate to
- Select your website domain
- Click the Foundation Pages tab
- Scroll to the Community Hub section
- Enter your hub page URL (e.g., "/communities")
- Save your settings
3
Create Community Pages
Build your neighborhood pages
Use the Community Page Builder to create individual community pages with specific MLS criteria.
Steps:
- Navigate to
- Click Create New Community Page
- Enter the page name (becomes part of URL)
- Select location area from dropdown or map
- Set optional criteria: property type, price range, beds, baths
- Assign to one or more Group Pages (required)
- Save the page
Instant Results: Your page is immediately live with MLS listings. AI-generated marketing content processes in the background and will appear automatically when ready.
Default Behavior
- Hub page displays the default group's community pages
- Individual community pages display current MLS listings matching the configured criteria
- AI-generated marketing content displays when processing is complete
- Listings update automatically as properties enter and leave the MLS
- Navigation breadcrumbs help users move between hub, group, and community pages
Integration Notes
WordPress Plugin Integration
When using the Buying Buddy WordPress plugin, a Community Hub template page (/community) is available to add during plugin setup. This automatically creates the foundation page with the correct widget installed.
SEO Benefits
- SEO-friendly URLs containing neighborhood and group names
- AI-generated meta titles and descriptions optimized for local searches
- Fresh content as listings change helps search engine rankings
- Structured page hierarchy improves site architecture
Lead Capture
The Lead Capture settings in your Buying Buddy account apply to community pages. Visitors can register to save properties and receive alerts based on the community page criteria.
Limitations
- Only one Communities Widget should be installed per website (on the hub page)
- Community pages must be assigned to at least one Group Page to appear on your website
- AI content generation runs in the background and may take several minutes to complete for new pages
- The hub page URL must be configured correctly in Foundation Page settings for routing to work
Troubleshooting
Community Page Not Appearing
- Verify the Community Hub page URL is correctly set in
- Confirm the community page is assigned to at least one Group Page
- Check that the page criteria returns actual listings in your MLS
- Clear any caching plugins that might prevent new pages from appearing
Pages Showing No Listings
- Review your search criteria—they might be too restrictive
- Check that the area name matches MLS data exactly
- Verify property types are available in the selected area
- Consider broadening price ranges if they're too narrow
AI Content Not Displaying
- AI content processing takes several minutes—allow time for generation to complete
- Check the Community Page Builder to see content generation status
- Listings display immediately; AI marketing content populates when ready