> ## 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.

# Analytics overview

> Dashboards and reports for clubs, members, operations, billing, marketing, and engagement.

The **Analytics** section is a collection of pre-built dashboards and detail reports. Each subsection is a dashboard with a few KPI cards at the top and one or more charts below; some dashboards link out to deeper per-metric reports.

There's no report builder or query interface - every report is a fixed page with predefined filters. If you need raw data, use [Settings > Export](/settings/export).

## What's available

* **[Clubs](/analytics/clubs)** - Two dashboards: **Today** (live hourly view of bookings, check-ins, revenue, and utilization, auto-refreshing every five minutes) and **Historical** (the same metrics over a selected date range).
* **[Members](/analytics/members)** - Members dashboard, attendance report, engagement progression, and balance report.
* **[Operations](/analytics/operations)** - Bookings dashboard, classes dashboard, and a monthly bookings report.
* **[Billing](/analytics/billing)** - Billing dashboard, revenue report, transactions report, and an invoices dashboard.
* **[Marketing](/analytics/marketing)** - Pipeline, deals, and promotion performance in one dashboard.
* **[Engagement](/analytics/engagement)** - Member engagement scoring (0-100 per member) and how scores change over time.

## How the dashboards work

Every analytics page shares the same three-part layout:

The **filter bar** at the top is where you pick the date range and (where it applies) a club to scope the report to. Most dashboards default to the last 30 days; the engagement dashboard defaults to 90 days. Some pages have additional filters (member type, contact, area type) directly above the relevant chart.

The **KPI cards** sit below the filter bar - usually three or four cards with a single number each (total revenue, average score, total members, etc.) and an icon.

The **charts** are below the cards. They're built with Recharts so hovering shows tooltips, the legend toggles series on and off, and you can pan/zoom on time-based charts.

## Data freshness

Most dashboards run live queries against your operational data, so as soon as a booking is created or a payment lands, it shows up. Two exceptions:

* The **Clubs > Today** dashboard reads hourly aggregates. It shows the timestamp of the last completed hour at the top of the page and auto-refreshes every five minutes.
* The **Engagement** scoring system writes scores in a background job (controlled by smart-tagging settings); the dashboard reads from that store, not the live activity tables.

## Time zones

All "today" and "this week" calculations use your organization's time zone (set under **Settings > Organization**). A booking that's "tomorrow" in your local time may already be "today" in the org's time zone or vice versa.

## Who can see what

Analytics access follows the standard role permission set:

* **Admin** sees everything.
* **Manager** has full analytics access (manage scope at club level).
* **Front desk** and **Instructor** can read their own analytics only - so an instructor sees their own classes and bookings, not the whole org.

See [Roles and permissions](/reference/roles-permissions) for the full breakdown.

## Tips

* **Set the date range once** at the top of the page. Most charts share the same range, so you don't need to set it per chart.
* **Compare clubs side by side** by running the Clubs > Historical dashboard with no club filter, then drilling in by clicking individual cards.
* **For raw data, export instead**. The Analytics pages are for reading; CSV exports under **Settings > Export** are for analysis in Excel, BI tools, or your accountant's software.

## Related

* [Dashboard](/dashboard/overview) - The home page rolls up a subset of these metrics into widgets.
* [Settings > Export](/settings/export) - Pull raw CSVs for offline analysis.
* [Roles and permissions](/reference/roles-permissions) - Who can read which reports.
