> ## Documentation Index
> Fetch the complete documentation index at: https://docs.1club.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Engagement analytics

> Member engagement scores (0-100) - distribution, recent changes, and progression over time.

The **Engagement dashboard** shows how engaged your members are right now and how their scores have moved over time. Scores are a 0-100 number per contact, calculated by a background job from booking frequency, spending, recent activity, and tenure.

<Note>
  Engagement *analytics* (this page) is the 0-100 scoring dashboard. The smart-tag category that groups members by recent check-ins is called **Attendance** and lives under [Smart Tagging](/settings/smart-tagging). They are different systems.
</Note>

## Score levels

The score maps to one of four levels (thresholds are fixed):

* **Rockstar** - 75 to 100. Highly engaged, frequent users.
* **High** - 50 to 74. Well-engaged regulars.
* **Medium** - 25 to 49. Moderate activity.
* **Low** - 0 to 24. At-risk, infrequent.

The same thresholds are used for the score chip on member pages and any tag-based automations driven by engagement.

## How scoring is calculated

The scoring service combines four equally-weighted categories by default:

* **Financial activity** (25%) - Recent transactions and payment activity.
* **Active services** (25%) - Active memberships and service usage.
* **Physical activity** (25%) - Check-ins, bookings, visit frequency.
* **Member engagement** (25%) - Activity consistency and tenure.

Weights and time windows are configurable per organization under [Smart Tagging](/settings/smart-tagging) - if scoring is disabled there, this dashboard shows no data. The "recent activity" window is derived from your engagement tag period; the "very recent" window is fixed at seven days.

Scores are written by a background job, not computed live. The dashboard reads from the stored scores, so newly created activity won't reflect until the next aggregation runs.

## What's on the page

### Filters

* **Date range** - Defaults to the last 90 days for the progression chart.
* **Contact type** - Restrict the progression chart to specific contact types (member, lead, drop-in, etc.).
* **Member** - Select a single contact to switch the chart from organization-wide averages to that member's own progression.

### KPI cards

Four cards across the top:

* **Total members** - All contacts considered for scoring in your org.
* **Average score** - Mean across members who have a score, plus the count of scored members as a subtitle.
* **Recent tag changes** - Engagement-related tag changes in the last seven days.
* **Recent score changes** - Score updates in the last seven days.

### Score distribution

A row showing how many members sit in each level: **Rockstar**, **High**, **Medium**, **Low**. Each is a count, color-coded.

### Progression chart

A line chart of average engagement score over time. The Y-axis is fixed at 0 to 100. The time bucket adapts to the date range.

When you select a single member, the chart switches to that member's individual score history (rendered green instead of blue). The legend label changes from **Average score** to **Engagement score**.

If a member doesn't have a score yet, you'll see **No score** in the panel above the chart and the chart will be empty.

## How to use this

* **Spot at-risk members early**. If the Low count grows week over week, members are slipping. Cross-check against recent tag changes for context.
* **Reward Rockstars**. Use the count of Rockstar-level members as the audience size for a loyalty campaign.
* **Track a specific member's journey**. Pick a member in the dropdown to see how their score moved - useful when investigating a churn case or qualifying a referral candidate.
* **Tune scoring before you trust it**. Calibrate weights and time windows under Smart Tagging until the levels match your gut feel about who's engaged, then use the dashboard for tracking.

## Limitations

* The dashboard is read-only. To change thresholds or weights, edit Smart Tagging settings.
* There's no "no-engagement-yet" filter - members without a score are silently excluded from the average and chart.
* Scores need data. Brand-new members and members in their first few weeks may not have a stable score until the next aggregation pass.

## Related

* [Smart tagging](/settings/smart-tagging) - Where engagement scoring is enabled and tuned.
* [Members analytics](/analytics/members) - Member-level metrics not tied to scoring.
* [Analytics overview](/analytics/overview) - Other dashboards.