What This Screen Does
This screen shows you how your contingent (recurring) memberships are distributed over a selected time period. Think of it like a bar chart report that breaks down how many members are on each type of contingent membership, month by month. You can also segment the data by gender or age to spot trends in your membership base.
How to Get There
Open the dashboard.
In the left-hand menu, click Insights.
Navigate to the Membership section.
Click Contingent Distribution.
You are now on the Contingent Distribution screen.
Step-by-Step Guide
1. Set the Date Range
The date range is controlled by the filters at the top of the Insights page.
Pick a From Date and a To Date to define the period you want to analyse.
The chart will update automatically once the dates change.
2. Filter by Membership Type (optional)
Use the Membership Type filter to narrow the report down to specific contingent membership types.
If you leave this empty, all contingent membership types are included.
3. Set Minimum Membership Length (optional)
You can filter out short-lived memberships by setting a Minimum Length of Membership in Days.
For example, entering
30will only include members who have been active for at least 30 days.This is useful for excluding trial memberships or very short sign-ups.
4. Choose a Segment
In the top-right corner of the chart card, you will see a segment selector button (it defaults to All).
Click the button to open a dropdown with three options:
Segment | What It Shows |
All | A single chart with all members combined. No breakdown. |
Gender | Separate data series for each gender group (e.g. Male, Female, Unspecified). |
Age | Separate data series for each age group. |
Pick the segment you want. The chart will reload with the new breakdown.
5. Read the Chart
Each chart displays a bar chart (column chart) with months along the horizontal axis and member counts on the vertical axis.
If you selected All, you will see one chart.
If you selected Gender or Age, you may see multiple charts — one for each group — sorted alphabetically by name.
Hover over a bar to see the exact number for that month.
The legend at the top-right of each chart shows which colour corresponds to which data series.
6. Review the Tooltip Information
Next to the segment selector, there is a small info icon (ℹ️).
Hover over it to see a reminder:
Included in this graph is all contingent membership types.
Guests and staff memberships are not included in this graph.
Filters Summary
Filter | Required | What It Does |
From Date | Yes | The start of the reporting period. |
To Date | Yes | The end of the reporting period. |
Membership Type IDs | No | Limits the report to specific contingent membership types. Leave empty for all. |
Minimum Length of Membership (days) | No | Excludes members whose membership is shorter than this number of days. |
Segment | Yes (defaults to All) | Choose how to break down the data: All, Gender, or Age. |
What Happens Behind the Scenes
You open the Contingent Distribution screen
|
v
The system checks your currently selected gym
|
v
API call: getContingentDistribution({
fromDate, toDate, segment,
membershipTypeIds, minimumLengthOfMembershipInDays
})
|
v
Server calculates membership distribution
for each month in the selected period
|
v
Data is returned as a list of chart series
(grouped by segment if Gender or Age is selected)
|
v
Charts render as bar charts on screen
|
v
When you change a filter or segment,
the API is called again and the charts refresh
Troubleshooting
“The chart is empty — no bars are showing”
Make sure the date range covers a period where you actually had active contingent memberships.
Check the Membership Type filter — you may have selected a type that has no members in the chosen period.
If the Minimum Length of Membership is set very high, it could be filtering out everyone. Try lowering it or removing it.
“I only see one flat chart when I expected a breakdown”
Check that you selected Gender or Age in the segment dropdown. The default is All, which shows everything combined in a single chart.
If you selected Gender or Age but still see only one chart, it may mean all your members fall into a single group for that segment.
“The chart takes a long time to load”
Large date ranges with many membership types can take longer to process.
Try narrowing the date range or filtering to fewer membership types.
Check your internet connection — a slow or unstable connection can delay the data.
“I see guests or staff in the numbers and they should not be there”
By design, guest and staff memberships are excluded from this chart. If the numbers look higher than expected, the extra count likely comes from contingent membership types you did not expect.
Review your membership types in the system settings to make sure they are categorised correctly.
“The month labels on the horizontal axis look wrong”
The horizontal axis shows months in MMM yyyy format (e.g. “Jan 2025”).
If the labels overlap or look garbled, try selecting a shorter date range so fewer months are displayed.
Widen your browser window to give the chart more horizontal space.
“I changed the gym but the chart did not update”
The chart should refresh automatically when you switch the selected gym in the dashboard header.
If it does not, try refreshing the page manually.
Make sure the new gym has contingent memberships set up — an empty chart may simply mean that gym has no data.
“I do not see the Contingent Distribution option in the menu”
This screen is part of the Insights section. Make sure your user role has permission to view insights.
If you cannot see the Insights menu item at all, contact your administrator to check your role permissions.
“The numbers do not match what I expected”
Remember that this chart only includes contingent (recurring) membership types. One-time passes, drop-in memberships, and non-contingent types are not counted.
Check whether the Minimum Length of Membership filter is excluding some members.
Verify that the date range covers the exact period you are comparing against.