What This Screen Does
This screen shows you a bar chart of how many guest members your gym had each month over a selected time period. Think of it like a monthly attendance report — but specifically for people who are not full-time members. Guest members are those with at least one active contingent, campaign, punch card, or personal training membership in a given month. It helps you spot trends and understand how guest traffic changes over time.
How to Get There
Open the dashboard.
In the left-hand menu, click Insights.
Scroll to the Guest Members chart card.
You are now viewing the Guest Members report.
Step-by-Step Guide
1. Select a Gym / Location
Make sure the correct gym is selected in the global gym selector at the top of the dashboard.
The chart automatically loads data for whichever gym you have selected.
If you switch gyms, the chart will reload with data for the new location.
2. Set the Date Range
Use the From Date and To Date filters at the top of the Insights page.
The chart will display one bar per month for every month in your selected range.
Choose a wider range (e.g. 12 months) to see long-term trends, or a shorter range to zoom in on recent activity.
Filter | Required | What to Enter |
From Date | Yes | The start of the period you want to analyse. Pick a date from the date picker. |
To Date | Yes | The end of the period. Must be the same as or later than the From Date. |
3. Filter by Membership Type (optional)
If membership type filters are available on the Insights page, you can narrow the report to specific membership types.
Leave this empty to include all qualifying types (contingent, campaign, punch cards, and personal training).
Filter | Required | What to Enter |
Membership Types | No | Select one or more membership types to include. If left empty, all qualifying types are included. |
4. Set Minimum Membership Length (optional)
You may set a minimum length of membership in days to exclude very short-term guests.
For example, setting this to 30 means only guest members whose membership lasted at least 30 days will be counted.
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. Leave empty to include all. |
5. Read the Chart
Each bar represents one month.
The x-axis (horizontal) shows months in “MMM yyyy” format (e.g. “Jan 2025”).
The y-axis (vertical) shows the total number of guest members.
Hover over a bar to see the exact number for that month.
If there is no data (all values are zero), the chart will appear empty.
6. Use the Tooltip for More Information
Click or hover over the info icon (ⓘ) next to the chart title.
A tooltip will appear explaining what counts as a guest member:
A person with at least one active membership in the given month.
Included membership types: contingent, campaign, punch cards, and personal training.
What Happens Behind the Scenes
You open the Insights page (or change a filter)
|
v
The system checks which gym is selected
|
v
Loading spinner appears on the chart
|
v
API call: getGuestMemberReport({ fromDate, toDate, membershipTypeIds, minimumLengthOfMembershipInDays })
|
v
Server returns monthly guest member counts
|
v
Chart renders one bar per month
|
v
Loading spinner disappears — data is displayed
Troubleshooting
“The chart is empty and shows no bars”
This means there were zero guest members in the selected date range.
Try expanding the date range to cover more months.
Make sure the selected gym actually has members with qualifying membership types (contingent, campaign, punch cards, or personal training).
“The chart is stuck on loading”
The data is fetched from the server each time you change a filter or switch gyms.
If it keeps spinning, check your internet connection.
Try refreshing the page. If the problem continues, the server may be experiencing issues — contact support.
“I changed the filters but the chart did not update”
The chart updates automatically when you change the date range, membership types, minimum membership length, or selected gym.
If it does not update, try refreshing the page.
Make sure your From Date is earlier than or equal to your To Date.
“The numbers seem too low”
Remember that this chart only counts guest members — people with contingent, campaign, punch card, or personal training memberships.
Regular full-time members are not included in this count.
If you set a minimum membership length, shorter memberships are excluded. Try removing that filter to see all guest members.
Check that you have selected the correct gym — data is shown per location.
“I do not see the Guest Members chart at all”
Make sure you are on the Insights page.
Your user role may not have permission to view insights. Ask an administrator to check your role permissions.
The chart may be further down the page — try scrolling down.
“The month labels on the x-axis are cut off or overlapping”
This can happen when you select a very long date range with many months.
Try narrowing the date range to display fewer months at once.
You can also try making your browser window wider.
“I switched gyms but still see the old data”
The chart reloads when you change the selected gym. Give it a moment to fetch the new data.
If the data does not change, refresh the page and select the gym again.
If the issue persists, both gyms may have similar guest member numbers — check the chart title and selected gym to confirm.