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="Communities"
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="Communities"></bb-widget>
[mbb_widget data-type="Communities"]
Parameters and Filters
Required Parameters
| Parameter | data-type="Communities" |
| Purpose | Defines the widget as a Communities Widget |
Widget-Specific Filters
On your main Community Hub page the widget needs no filter - it displays the right content based on the page URL (see URL Structure below). You can, however, add an optional data-filter to make a specific widget instance always show a chosen group or community. This is what lets you feature a group somewhere other than the hub page, such as a home page or landing page.
| group:<group-slug> | Displays the index of communities in the named group. |
| community:<community-slug> | Displays a single named community page. |
The value is the item's slug - the last part of its page URL - not its display name and not a numeric ID. For example, a group whose page is /communities/featured-areas has the slug featured-areas. To find a group's slug, open the Community Page Builder and use the link icon on the group's row to copy its page URL; the slug is the final part of that address.
Example - show the "featured-areas" group:
<bb-widget data-type="Communities" data-filter="group:featured-areas"></bb-widget>
[mbb_widget data-type="Communities" data-filter="group:featured-areas"]
If both a group and a community are given, the community takes precedence. When no filter is set at all, the widget falls back to your account's default group.
Tip: You can also drive the group from the page URL using ?filter=group:featured-areas, which overrides the widget's own data-filter. This is the same filter form described in Organizing Communities with Groups.
Embedding a Group on Another Page
Besides powering your Community Hub, the Communities Widget can be embedded on any other page to feature a single group's community index inline - for example, a "Communities I Serve" section on your home page. Add the widget with a group: filter naming the group you want to show:
<bb-widget data-type="Communities" data-filter="group:featured-areas"></bb-widget>
[mbb_widget data-type="Communities" data-filter="group:featured-areas"]
The embedded widget shows that group's list of communities. Each community links through to its full page on your main Community Hub, so visitors move from the featured list straight into your existing community pages - you don't duplicate any content, and there is nothing extra to maintain.
Tip: This is an easy way to showcase your farm areas on a home page, landing page, or agent bio page while keeping all of your community-page content in one place - your Community Hub.
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
On your Community Hub page, the Communities Widget works differently from most other Buying Buddy widgets: it reads the URL path and displays content based on what you've configured in the Community Page Builder, so it needs no filter to show the right page. When you want a specific widget instance to always show a chosen group or community, you can add an optional filter - see Widget-Specific Filters above.
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
- Your site has one Community Hub page (the foundation page), which powers all of your community and group pages. You can still embed additional Communities widgets on other pages using a
group:filter - see Embedding a Group on Another Page above. - 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
Embedded Group Not Showing
- Check that the
group:value is the group's slug (the last part of its page URL), not its display name - Confirm the group exists and has at least one community page assigned to it
- If a page URL includes
?filter=group:..., remember it overrides the widget's owndata-filter
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