What This Screen Does

This screen shows you how many punch card memberships were active over a period of time. Think of it like a monthly attendance chart — but instead of tracking people, it tracks how many punch card memberships were in use each month. The data is displayed as a candlestick chart, where each “candle” shows the opening count, closing count, highest point, and lowest point for that month. Horizontal lines mark the overall median and average so you can quickly see trends.

How to Get There

Open the dashboard.
In the left-hand menu, click Insights.
Navigate to the membership insights area.
You will see the Active punch card memberships card on the page.

Step-by-Step Guide

1. Select a Date Range

Use the From Date and To Date filters at the top of the insights page.
The chart will only show data for the period you select.
Each month within that range gets its own candlestick on the chart.

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. Must be after the From Date.

2. Filter by Membership Type (optional)

If available, use the Membership Type filter to narrow results to specific punch card membership types.
Leave it blank to include all punch card membership types.

Filter	Required	What to Enter
Membership Types	No	Select one or more punch card membership types from the dropdown. Leave empty for all.

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 30 will only count memberships that lasted at least 30 days.

Filter	Required	What to Enter
Minimum Length of Membership (Days)	No	A number representing the minimum number of days a membership must last to be included.

4. Read the Chart

The chart is a candlestick chart. Each candlestick represents one month.
The x-axis (horizontal) shows the month and year (e.g. “Jan 2025”).
The y-axis (vertical) shows the number of active punch card memberships.
Each candlestick has four data points:
- Open — the number of active memberships at the start of the month.
- Close — the number of active memberships at the end of the month.
- High — the peak number of active memberships during the month.
- Low — the lowest number of active memberships during the month.
A blue horizontal line marks the Median across all months.
An orange horizontal line marks the Average across all months.

Hover over the info icon (ℹ) in the top-right corner of the card.
It explains that only punch card memberships are counted — guest and staff memberships are excluded.

6. Switch Gym / Location

The chart automatically updates when you change the selected gym in the dashboard header.
Data is always scoped to the gym you currently have selected.

What Happens Behind the Scenes

You set the date range and filters
        |
        v
The system checks which gym is selected
        |
        v
API call: getActivePunchCardMemberships({
  fromDate, toDate, membershipTypeIds,
  minimumLengthOfMembershipInDays
})
        |
        v
Server calculates monthly open/close/high/low
counts for active punch card memberships
        |
        v
Server also calculates the median and average
        |
        v
Data is returned and the candlestick chart renders
        |
        v
Median (blue line) and Average (orange line)
are drawn on the chart

Troubleshooting

“The chart is empty — I do not see any data”

Make sure the date range covers a period when punch card memberships were active.
Check that the correct gym is selected in the dashboard header. The chart only shows data for the currently selected location.
If you have a membership type filter applied, try clearing it — you may have selected a type with no active memberships in that period.

“I only see regular memberships, not punch card memberships”

This chart is specifically for punch card memberships only. If your gym does not use punch card memberships, the chart will be empty.
Regular (recurring) memberships are tracked on a separate insights screen.
Guest and staff memberships are also excluded from this chart.

“The chart is stuck on loading”

The data may take a moment to load, especially for large date ranges.
Try refreshing the page. If the spinner does not stop, check your internet connection.
If the problem continues, the insights API may be temporarily unavailable — try again in a few minutes or contact support.

“The numbers on the chart seem too low”

Remember that guest and staff memberships are not included. Only punch card memberships count.
If you set a Minimum Length of Membership filter, short-lived memberships are excluded. Try setting this to 0 or leaving it blank.
Verify you are looking at the correct gym — switch gyms in the header and compare.

“The median and average lines are not showing”

These lines only appear when there is actual data in the chart. If all values are zero, the lines are hidden.
Make sure your date range and filters return at least some non-zero data.

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

The chart should refresh automatically when you switch gyms. If it does not, try refreshing the page.
Confirm the new gym has punch card memberships set up. A gym with no punch card memberships will show an empty chart.

“The month labels on the x-axis are hard to read”

The labels are displayed at an angle to fit more months on the screen. This is normal for wide date ranges.
Try narrowing your date range to show fewer months, which gives each label more space.

“I want to export or download this data”

This chart does not have a built-in export button.
If you need the raw numbers, contact your administrator or check if your plan supports data exports from the Insights section.

Punch Card Distribution