What This Screen Does

This screen shows you how punch card memberships are spread across your members over a selected time period. Think of it like a report card that breaks down how many punch cards were used each month — and lets you slice that data by gender or age group. It helps you understand which punch card types are popular and spot trends over time.

How to Get There

Open the dashboard.
In the left-hand menu, click Insights.
Navigate to the Membership section within Insights.
Scroll to the Punch Card Distribution chart.
You are now viewing the Punch Card Distribution screen.

Step-by-Step Guide

1. Set the Date Range

The chart uses the date range selected in the Insights filters at the top of the page.
Pick a From Date and a To Date to define the period you want to examine.
The chart will reload automatically when you change the dates.

2. Filter by Membership Type (optional)

If you only want to see specific punch card membership types, use the Membership Type filter at the top of the Insights page.
Select one or more membership types from the list.
Leave it empty to include all punch card membership types.

3. Set Minimum Membership Length (optional)

Use the Minimum Length of Membership filter to exclude members who have been signed up for fewer than a certain number of days.
This helps you focus on established members rather than brand-new 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 the segment menu.
Choose how you want the data broken down:

Segment	What It Shows
All	One combined view of all punch card data — no breakdown.
Gender	Splits the data by gender (e.g. Male, Female, Unspecified).
Age	Splits the data by age group.

After you pick a segment, the chart reloads automatically.
When segmented by Gender or Age, you will see separate charts for each group, sorted alphabetically.

5. Read the Chart

Each chart is a bar chart (also called a column chart).
The horizontal axis (bottom) shows months in the format “MMM yyyy” (e.g. “Jan 2026”).
The vertical axis (left) shows the count of punch cards. Large numbers are shortened (e.g. 1,000 becomes “1k”).
Each colored bar represents a different data series (punch card type).
A legend at the top-right of the chart tells you which color belongs to which series.
Hover over any bar to see the exact value.

Next to the segment selector, there is a small info icon (ℹ).
Hover over it to see a reminder:
- Included: All punch card membership types.
- Not included: Guest memberships and staff memberships.

What Happens Behind the Scenes

You change dates, segment, or filters
        |
        v
The system checks that a gym is selected
        |
        v
Loading spinner appears on the chart
        |
        v
API call: getPunchCardDistribution({
  fromDate, toDate, segment,
  membershipTypeIds, minimumLengthOfMembershipInDays
})
        |
        v
Server returns distribution data grouped by series
        |
        v
Data is sorted alphabetically by chart name
        |
        v
Bar charts render — one chart per group
(or one chart if segment is "All")
        |
        v
Loading spinner disappears, chart is ready

Troubleshooting

“The chart is empty — there are no bars at all”

Make sure the date range actually covers a period when punch cards were active.
Check that the selected gym has punch card membership types set up. If no punch card types exist for that location, there is nothing to display.
If you have a membership type filter active, try clearing it — you may have filtered out all the relevant types.

“I only see one chart but I expected multiple”

Check which segment is selected. If it is set to All, you will see a single combined chart.
Switch to Gender or Age to break the data into separate charts.

“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 to a shorter period (e.g. one quarter instead of a full year).
Check your internet connection — a slow or unstable connection can delay the response.

“I do not see guest or staff memberships in the chart”

This is by design. The Punch Card Distribution chart only includes punch card membership types.
Guest memberships and staff memberships are intentionally excluded.
Hover over the info icon (ℹ) next to the segment selector for a reminder of this rule.

“The numbers on the left axis look strange or abbreviated”

The chart shortens large numbers for readability. For example, 1,500 is shown as “1.5k” and 1,000,000 as “1M”.
Hover over an individual bar to see the exact, unabbreviated value.

“I changed the gym but the chart did not update”

The chart should reload automatically when the selected gym changes. If it does not, try refreshing the page.
Make sure the new gym has punch card membership types configured.

“The segment selector is not responding”

Click directly on the segment button text (e.g. “All”). A dropdown menu should appear.
If nothing happens, try refreshing the page — a temporary glitch may be preventing the menu from opening.
If the problem persists, check your browser for JavaScript errors or try a different browser.