Booking Rules
Limit how many sessions an athlete can book per week or month, how far ahead and how late they can book, and how late they can cancel; scope each rule to a level, session type, activity, location or space.
Overview
Booking rules are checks the system runs when an athlete is booked onto a session or cancels a booking. Staff (coaches and admins) create them under Facility > Booking Rules. There are four rule types, and each rule can be limited to a subset of sessions with filters. A rule with no filters applies to every session.
Athletes and parents do not see the rules listed anywhere. They see the rule's message when a booking or cancellation is refused.
How To
Create a rule
- Go to Facility > Booking Rules and click Add Rule (or Create First Rule).
- Pick a Rule Type and fill in its fields.
- Optionally set filters under Filters (Optional).
- Leave Enable this rule on and click Create Rule.
| Rule Type | Fields | What it enforces |
|---|---|---|
| Maximum Bookings Per Week / Month | Maximum Bookings, Per (Week or Month) | Caps the athlete's active bookings in the Sunday to Saturday week, or the calendar month, that the session falls in. |
| Advance Booking Window | Advance Value, Unit (Days, Weeks, Months) | The session must start no later than this far from now. |
| Hours Before Start | Hours Before Start | The booking must be made at least this many hours before the session starts. Also sets when the card is charged. |
| Cancellation Window | Cancellation Value, Unit (Hours, Days, Weeks, Months) | Athletes and parents cannot cancel inside this window before the start. |
All numeric fields must be at least 1. The form defaults are 3 per week, 14 days, 2 hours and 1 day.
Scope a rule with filters
| Filter | Matches a session when |
|---|---|
| Level | The session's level slug equals the chosen value, ignoring case. Choices: Rookies, Youth, High School, College, Pro. |
| Session Type | The session is Group, One on One, Team or Camp. |
| Training Activity | The chosen activity is one of the session's activities. |
| Location | The session is at that location. |
| Space | The chosen space is one of the session's spaces. Pick a Location first to list its spaces. |
Every filter you set must match (AND). A session that fails any one of them is not covered by the rule. Changing the location clears the space filter.
For a maximum-bookings rule, the filters also decide which existing bookings count toward the limit: only bookings on sessions that match the same filters are counted. A rule for "Group at Main Facility" counts group bookings at Main Facility and ignores private lessons elsewhere.
Edit, disable or delete a rule
On the rule card, the pencil opens the same form (Update Rule) and the trash icon deletes after a browser confirmation. Turn Enable this rule off to keep a rule without enforcing it; the card then shows Disabled.
Rules scoped to an activity, location or space are deleted automatically when that activity, location or space is deleted.
Know when several rules match
There is no ranking between rules. Every enabled rule whose filters match the session is checked, and the first violation stops the booking with that rule's message. Two maximum-bookings rules with different filters each keep their own count. A broad rule and a narrow rule on the same sessions both apply; the stricter one is simply the one that trips first.
The one place rules combine is charge timing. The card for a paid group session is charged at the Hours Before Start value of the matching rule (24 hours when no rule matches). When a Cancellation Window rule also matches and is shorter than that, the charge moves to the cancellation cutoff instead, so the charge happens after cancellations are final. See Booking Payments.
Know who is checked
| Booking path | Max bookings | Advance window and hours before start | Cancellation window |
|---|---|---|---|
| Single session, booked by anyone | Everyone, staff included | Everyone, staff included | Athletes and parents blocked; staff can cancel, booking flagged as a late cancel |
| Recurring series booked as a whole | Athletes and parents only, across the whole series | Not checked | As above |
| Camp registration | Athletes and parents only | Not checked | As above |
| Lesson or rental from opening hours | Everyone | Everyone | As above |
A lesson or rental booking is a one-on-one session with a location and one space but no activity or level, so only rules without an activity or level filter can match it.
Read the messages athletes see
Violations come back as a notification in the booking or cancel dialog. The wording includes the rule's filters when it has any:
- "You have reached your booking limit of 3 for Group sessions this week (currently 3/3)"
- "This session is too far in advance (max 14 days)"
- "Bookings must be made at least 2 hours before the session starts (athletes are charged at this cutoff)"
- "Cancellations must be made at least 1 day before the session starts"
A series booking that would exceed a weekly limit is refused as a whole, naming the week: "... for the week of 2026-03-08".
Tips
- Start with one unfiltered cancellation window. It protects your headcount and also decides when group-session cards are charged.
- Use the Space filter for scarce equipment: a limit of 2 per week scoped to the mound keeps one athlete from booking every mound slot.
- Weekly limits count the Sunday to Saturday week of the session, not the week the booking is made in. Booking next week's sessions never uses this week's allowance.
- Disable a rule instead of deleting it during a camp week or a promotion, then turn it back on.
- Staff can book over a weekly limit on series and camps on purpose; treat that as an override, not a bug.
Troubleshooting
An athlete got "You have reached your booking limit" but has fewer bookings than the limit. The count includes every non-cancelled booking of the athlete that matches the rule's filters in that week or month, including bookings staff made for them. Check Facility > All Bookings filtered to the athlete.
The rule never fires. Check it shows Enabled, then compare its filters to the session: activity, location and space must all match the session exactly. A Level filter only matches when the session has that level pinned; Any Level sessions never match a level filter.
The Level filter does not match my sessions.
The filter compares its value to the level's slug ignoring case. Rookies, Youth and College match the default slugs; High School and Pro do not match the default slugs highschool and professional. Use the activity, type or location filters for those levels.
Athletes can't cancel. They are inside the cancellation window. Staff can cancel for them from Facility > All Bookings; the booking is then marked as a late cancel.
Staff got blocked by a rule when booking for an athlete. Single-session bookings apply every rule to whoever books. Disable the rule briefly, or book the athlete onto the whole series, which skips the advance and hours-before checks.
Cards were charged earlier than the hours-before rule says. A shorter cancellation window also matched the session, and the charge moved to that cutoff.
"period must be one of WEEK, MONTH" The API received a period outside those two values. In the form, use the Per dropdown.
Related
- Booking Payments
- Sessions & Availability
- Bookings & Check-In
- Opening Hours & Rates
- Training Activities & Levels
- Locations & Spaces
Referenced by
- 'Bookings & Check-In'facility
- 'Facility Management Overview'facility
- 'Locations & Spaces'facility
- 'Training Activities & Levels'facility