๐Ÿ’ฌ 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.


โš™๏ธ What the Agent Can Do๐Ÿงฉ Groups Analytics (10 Tools)

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.

๐Ÿ’ฌ Forums Analytics (5 Tools)

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.

๐Ÿ“Š Core Analytics ConceptsGroup Engagement Score
Forum Engagement Score
Group Categories
TypeCriteriaMeaning
Small<5 membersEarly-stage, high potential
Medium5โ€“10 members
Growing stability
Large>10 membersEstablished, retention focus
Activeโ‰ค7 days inactivity
Healthy engagment
Moderate7-60 daysNeeds encouragement
Dormant>60 days
Requires reactivation
๐Ÿงฎ Key Input Parameters
ParameterRequiredDescription
tenant_idโœ…
Unique site identifier
group_idOptionalTarget group ("all" or ID)
limitOptionalResult size (default 5โ€“10)
daysOptionalRange (7, 30, 90)
compare_to_previousOptionalEnables trend comparison
๐Ÿ” Typical WorkflowsCommunity Health Overview
  1. bb_groups_health_analysis

  2. bb_forums_health_analysis

  3. bb_groups_vitality_metrics

    โ†’ Provides a combined health snapshot.

Growth & Retention Analysis
  1. bb_groups_growth_trends

  2. bb_groups_vitality_metrics

  3. bb_groups_by_size

    โ†’ Identifies small, high-potential groups.

Forum Performance Review
  1. bb_forums_performance_insights

  2. bb_forums_bottom_performers

    โ†’ Surfaces improvement areas and discussion gaps.

Engagement Deep Dive
  1. bb_groups_top_contributors

  2. bb_groups_activity_patterns

    โ†’ Reveals your champions and peak activity windows.

๐Ÿ“ˆ Key Metrics Reference
MetricGoodWarningPoor
Engagement Score>10050-100<50

Days Since Activity<77-30>30
Growth Rate %
>10%
5-10%<5%
Activities/Member>31-3<1
Topic/Forum>105-10<5
Replies/Topic>52-5<2
๐Ÿ—“๏ธ Data Retention by Plan
PlanRetention Period
Core30 days
Pro90 days
Max180 days
Free7 days
๐Ÿง  Best Practices
  • 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.

Was this article helpful?

0 out of 0 liked this article

Still need help? Message Us