Pre-filtering the FitnessHub schedule

Whilst the FitnessHub schedule can be filtered manually by users, it is also possible to build up custom URLs that pre-filter the schedule. When these URLs are used, the schedule filter settings are already set. This is particularly useful when onboarding new members or when you want to send members to book a particular session type.

To build up a custom filtered URL, follow these steps:

1. From the Report Centre within the Reporting section of the main menu, download the System > System IDs report.
   This report provides the unique numeric codes that identify each of your session types (event names), venues, tags, and event types. The IDs will be unique within your system, but other GymOS users may have overlapping IDs.
2. Navigate to your FitnessHub member site, and find the URL for your schedule page.
   This will be https://[your url]/schedule/, where [your url] is your own FitnessHub domain.
   This is your “stem URL”.
3. You pre-apply a filter by specifying one or more URL parameters. These are:
   • dt
     Provide a date for the schedule to show. Format yyyy-mm-dd
   • fv
     Filter to one or more venue IDs
   • fen
     Filter to one or more session types (event names)
   • fet
     Filter to one or more classifications (event types)
   • ft
     Filter to one or more tags
4. Multiple values may be provided as a comma-separated list (no spaces)
5. Parameters must be suffixed to the stem URL, separated by ? and & characters.
   A ? is used before the first parameter, and a & before every subsequent parameter. The order of the parameters does not matter. Each parameter should appear at most once.
6. An additional parameter, next=1, may be added to have the scheduled automatically jump to the date (within the schedule’s range) when one or more sessions match the provided filter criteria. This is a very useful way of showing members the next session of a given type.

Examples

Below are a couple of examples. We shall assume our stem URL is https://mygym.com/schedule/

Filter to “Run Club” session type, showing the next scheduled session

Let’s assume “Run Club” has an ID of 3920. The URL would be:
https://mygym.com/schedule/?fen=3920&next=1

Filter to “Team Training” session type on 6th January 2027

Let’s assume “Team Training” has an ID of 4298. The URL would be:
https://mygym.com/schedule/?fen=4298&dt=2027-01-06

Filter to “Small Group” and “Large Group” sessions, at our HQ venue

Let’s assume “Small Group” has an ID of 4222, “Large Group” has an ID of 4223, and our “HQ” venue has an ID of 98. The URL would be:
https://mygym.com/schedule/?fv=98&fen=4222,4223