๐ฌ BuddyBoss Agent Guide
Agent Type: Analytics & Insights
Purpose: Analyze Groups and Forums performance, member engagement, and community health across BuddyBoss/BuddyPress environments.
๐ฏ Overview
The BuddyBoss/BuddyPress Analytics Agent is your data-driven companion for understanding community dynamics on BuddyBoss-powered WordPress sites. It helps administrators and community managers uncover engagement patterns, identify top-performing spaces, detect dormant areas, and make informed decisions to strengthen participation and growth.
Each connected site operates as a tenant, uniquely identified by a tenant_id (e.g., j7KlLfWcMcTT), ensuring insights remain isolated and secure per community.
Gain full visibility into your community groups.
Engagement Analysis
bb_groups_top_performers โ Shows your most engaging groups.
bb_groups_bottom_performers โ Highlights groups that need attention.
Health Metrics
bb_groups_health_analysis โ Measures overall community health.
bb_groups_vitality_metrics โ Tracks growth rate, activity age, and member churn.
bb_groups_by_activity_level โ Segments groups into Active, Moderate, or Dormant.
Segmentation
bb_groups_by_status โ Compares public vs private groups.
bb_groups_by_size โ Categorizes by member count (small, medium, large).
Growth & Activity
bb_groups_growth_trends โ Monitors growth trajectories.
bb_groups_activity_patterns โ Analyzes when and how members interact.
bb_groups_top_contributors โ Lists your most active members.
bb_groups_time_range_analysis โ Compares activity across timeframes.
Understand participation and discussion health.
Performance Metrics
bb_forums_top_performers โ Identifies the most engaging forums.
bb_forums_bottom_performers โ Finds underperforming forums.
Health & Segmentation
bb_forums_health_analysis โ Evaluates forum activity and reply ratios.
bb_forums_by_status โ Breaks down public/private forum performance.
Comprehensive Insight
bb_forums_performance_insights โ Delivers a complete forum overview.
| Type | Criteria | Meaning |
| Small | <5 members | Early-stage, high potential |
| Medium | 5โ10 members | Growing stability |
| Large | >10 members | Established, retention focus |
| Active | โค7 days inactivity | Healthy engagment |
| Moderate | 7-60 days | Needs encouragement |
| Dormant | >60 days | Requires reactivation |
| Parameter | Required | Description |
| tenant_id | โ
| Unique site identifier |
| group_id | Optional | Target group ("all" or ID) |
| limit | Optional | Result size (default 5โ10) |
| days | Optional | Range (7, 30, 90) |
| compare_to_previous | Optional | Enables trend comparison |
bb_groups_health_analysis
bb_forums_health_analysis
bb_groups_vitality_metrics
โ Provides a combined health snapshot.
bb_groups_growth_trends
bb_groups_vitality_metrics
bb_groups_by_size
โ Identifies small, high-potential groups.
bb_forums_performance_insights
bb_forums_bottom_performers
โ Surfaces improvement areas and discussion gaps.
bb_groups_top_contributors
bb_groups_activity_patterns
โ Reveals your champions and peak activity windows.
| Metric | Good | Warning | Poor |
| Engagement Score | >100 | 50-100 | <50 |
| Days Since Activity | <7 | 7-30 | >30 |
| Growth Rate % | >10% | 5-10% | <5% |
| Activities/Member | >3 | 1-3 | <1 |
| Topic/Forum | >10 | 5-10 | <5 |
| Replies/Topic | >5 | 2-5 | <2 |
| Plan | Retention Period |
| Core | 30 days |
| Pro | 90 days |
| Max | 180 days |
| Free | 7 days |
Start broad (health analysis) โ then drill down (vitality, top/bottom performers).
Combine groups + forums data for richer insights.
Use time range analysis for weekly or monthly comparisons.
Prioritize actionable recommendations, not raw data.
Highlight trends and outliers for management decisions.
The BuddyBoss/BuddyPress Analytics Agent gives you a clear window into the heart of your community โ helping you see where itโs thriving, where itโs slowing down, and how to spark deeper engagement.