What This Screen Does
This screen shows you how many unique customers made a purchase each month over a selected time period. Think of it like a monthly attendance sheet for paying customers — it helps you see trends, spot slow months, and understand your customer base. You can also break the data down by gender or age group to learn more about who your customers are.
How to Get There
Open the dashboard.
In the left-hand menu, click Insights.
Navigate to the Sales section.
Find the Monthly number of customers chart.
You are now viewing the Number of Customers screen.
Step-by-Step Guide
1. Set the Date Range
The chart respects the From Date and To Date filters set at the top of the Insights page.
Adjust these dates to control the time period shown in the chart.
The chart will automatically reload when you change the dates.
Filter | Required | What to Enter |
From Date | Yes | The start date for the report. Pick a date from the date picker. |
To Date | Yes | The end date for the report. Pick a date from the date picker. |
2. Filter by Membership Type (optional)
If membership type filters are available at the top of the Insights page, you can select one or more membership types.
The chart will update to show only customers who belong to the selected membership types.
Leave this empty to include all customers regardless of membership type.
3. Choose a Segment
In the top-right corner of the chart card, you will see a segment selector button (it defaults to All).
Click it to open a dropdown menu with three options:
Segment | What It Shows |
All | A single line showing total customers per month, plus a dashed line for comparison (e.g. previous period). |
Gender | Stacked area chart broken down by gender (e.g. Male, Female, Unspecified). Each gender gets its own color. |
Age | Stacked area chart broken down by age group. Each age bracket gets its own color. |
Click your preferred segment. The dropdown will close and the chart will reload with the new breakdown.
4. Read the Chart
The X-axis (horizontal) shows months, formatted as “MMM yyyy” (e.g. “Jan 2025”).
The Y-axis (vertical) shows the number of unique customers.
Two horizontal reference lines appear when there is data:
A blue line labeled Median — the middle value of all monthly totals.
An orange line labeled Average — the mean of all monthly totals.
Hover over the chart to see exact values for each data point.
The legend at the top-right of the chart tells you what each line or color represents.
5. Understand the Tooltip
The info tooltip (the small ⓘ icon next to the segment selector) explains what counts as a customer:
Included are all customers that have made a purchase in the given month.
This means only customers with at least one transaction in a given month are counted.
What Happens Behind the Scenes
You open the Insights page (or change filters)
|
v
The system checks which gym is currently selected
|
v
API call: getNumberOfCustomers({ fromDate, toDate, segment, membershipTypeIds })
|
v
Server calculates unique customers per month for the selected period
|
v
Server returns: monthly series data, median value, and average value
|
v
Chart renders the data as an area chart with reference lines
|
v
You see the updated chart on screen
Troubleshooting
“The chart is empty and I do not see any data”
Make sure the date range covers a period where purchases actually happened.
Check that the correct gym/location is selected in the dashboard header. The chart only shows data for the currently selected gym.
If you have membership type filters active, try clearing them — the selected types may have no customers in the chosen period.
“The chart is loading forever”
This usually means the server is taking a long time to process a large date range.
Try narrowing the date range to a shorter period (e.g. 6 months instead of 2 years).
Check your internet connection. If you are on a slow network, give it a few extra seconds.
If it still does not load, refresh the page and try again.
“I changed the segment but the chart looks the same”
When you switch from All to Gender or Age, the chart type changes from a simple area chart to a stacked area chart. The overall shape may look similar, but the colors will change to represent the different groups.
Check the legend at the top-right of the chart — it will list the individual segments (e.g. “Male”, “Female”, or age ranges).
If all your customers fall into one category, you may only see a single color even in segmented mode.
“The median and average lines are not showing”
These reference lines only appear when there is actual data in the chart (at least one month with more than zero customers).
If your date range returns no results, the lines will be hidden.
Try expanding the date range or removing membership type filters.
“The numbers seem too low”
Remember, this chart counts unique customers who made a purchase in each month — not total purchases or visits.
A customer who made 10 purchases in one month still counts as one customer.
If you are expecting higher numbers, check whether the correct gym is selected and whether your membership type filters are too narrow.
“I do not understand what ‘Median’ and ‘Average’ mean”
Average (orange line): Add up all the monthly customer counts and divide by the number of months. This gives you the typical monthly value but can be skewed by unusually high or low months.
Median (blue line): Sort all the monthly counts from lowest to highest and pick the one in the middle. This gives you a more balanced picture that is not affected by extreme outliers.
“The month labels on the X-axis are hard to read”
The labels are displayed at a 45-degree angle to fit more months on screen.
If the chart feels cramped, try reducing the date range so fewer months are shown.
You can also hover over individual data points to see the exact month and value.
“I selected a different gym but the chart did not update”
The chart automatically reloads when you change the selected gym in the dashboard header. If it did not update, try refreshing the page.
Make sure the gym you selected has sales data for the chosen date range.