What This Screen Does
This screen shows you how many customers bought a recurring product (like a membership) each month over a given time period. Think of it as a monthly headcount of your loyal, subscription-based customers. The data is displayed as an area chart with median and average lines so you can quickly spot trends — are your recurring customers growing, shrinking, or staying flat? You can also break the numbers down by gender or age group.
How to Get There
Open the dashboard.
In the left-hand menu, click Insights.
Navigate to the Sales tab.
Scroll to the Monthly number of recurring customers card.
You are now viewing the Recurring Number of Customers chart.
Step-by-Step Guide
1. Set the Date Range
The chart uses the From Date and To Date filters that are shared across the Insights / Sales page.
Adjust these date filters at the top of the page to control which months appear on the chart.
The x-axis will display each month in the range (formatted as “MMM yyyy”, e.g. “Jan 2025”).
2. Filter by Membership Type (optional)
If the page provides a Membership Type filter, use it to narrow the chart to specific recurring products.
When no membership types are selected, the chart includes all recurring products.
3. Choose a Segment
In the top-right corner of the card, you will see a segment selector button (it shows the currently selected segment).
Click it to open a dropdown menu with three options:
Segment | What It Shows |
All | A single line for all recurring customers, plus a dashed line for comparison. |
Gender | Multiple stacked areas, one for each gender category (e.g. Male, Female, Unspecified). |
Age | Multiple stacked areas, one for each age group. |
Click the segment you want. The chart will reload with the new breakdown.
Tip: When you choose Gender or Age, the chart switches to a stacked area view so you can see how each group contributes to the total.
4. Read the Chart
X-axis: Each point represents a month (e.g. “Jan 2025”).
Y-axis: The number of recurring customers.
Legend: Appears at the top-right of the chart area. It tells you what each colored area represents.
Median line (blue): A horizontal blue line showing the median value across the displayed months.
Average line (orange): A horizontal orange line showing the average value across the displayed months.
Hover over any data point to see the exact number for that month.
5. Use the Info Tooltip
Next to the segment selector, there is a small info icon (ⓘ).
Hover over it to read a description: “Includes all customers that have bought a recurring product in the given month like a membership.”
This is a quick reminder of what “recurring customer” means in this context.
What Happens Behind the Scenes
You open the Insights / Sales page (or change filters)
|
v
The system reads your selected gym, date range,
segment, and membership type filters
|
v
API call: getRecurringNumberOfCustomers({
fromDate, toDate, segment, membershipTypeIds
})
|
v
Server returns monthly series data,
plus median and average values
|
v
Chart renders an area graph with the series data
|
v
Median (blue) and Average (orange) annotation
lines are drawn on the y-axis
|
v
You see the completed chart
Troubleshooting
“The chart is empty — I do not see any data”
Make sure you have selected a date range that contains months where customers purchased recurring products.
Check that the correct gym / location is selected in the global gym selector at the top of the dashboard.
If you are filtering by membership type, try removing the filter to see if data appears for all types.
“The chart is loading forever”
This usually means the API call is taking a long time. Try selecting a shorter date range to reduce the amount of data.
Check your internet connection — if it dropped, the request may have timed out.
Try refreshing the page. If the problem persists, contact your administrator.
“The median and average lines are missing”
These lines only appear when there is at least one month with a value greater than zero.
If all months show zero recurring customers, the lines will not be drawn.
Widen your date range or check your membership type filter to include products that have active customers.
“I changed the segment but the chart looks the same”
After selecting a new segment (All, Gender, or Age), the chart reloads from the server. Wait a moment for the loading to complete.
If you switch to Gender or Age and the breakdown looks identical to All, it may mean your data only has one gender or one age group recorded. Check that customer profiles have their gender and date of birth filled in.
“The numbers on the chart do not match what I expected”
This chart counts customers who bought a recurring product in a given month — it does not count one-time purchases or drop-ins.
A customer is counted in every month their recurring product is active, not just the month they first purchased it.
If you are filtering by specific membership types, make sure you have selected all the types you want to include.
“I do not see the Gender or Age segment options”
The segment dropdown should always show All, Gender, and Age. If it does not appear, try refreshing the page.
If the dropdown button is missing entirely, your screen may be too narrow. Try widening your browser window.
“The month labels on the x-axis are overlapping or hard to read”
The labels are rotated at a 45-degree angle to save space. If you have a very long date range (many months), the labels may appear crowded.
Try selecting a shorter date range to reduce the number of months displayed.
You can also try making your browser window wider to give the chart more horizontal space.