Booking Rules

Modified on Tue, 23 Jun at 4:04 PM

How Rules Apply

A Rule is a container. The real behaviour comes from its RuleOptions, then the rule is attached to a resource.

Rules can be restricted to groups or teams.

When multiple rules apply to the same resource, the code collates them by option type, and the later attachment wins for duplicate option names.

Booking Rules

Rule	Summary
`duration`	Sets minimum and/or maximum booking length in hours. Used to stop very short or very long bookings.
`leadtime`	Prevents bookings too close to the start time. Example: “must book at least 2 hours ahead.”
`booking_buffers`	Adds required buffer time before and after existing bookings on the same resource. Prevents bookings from being placed too tightly together.
`advance_booking`	Limits how far into the future a booking can be made. Supports hours or days, optional weekend exclusion, and optional daily opening offset.
`concurrent_desks`	Limits how many overlapping bookings a user can have for resources with a matching concurrent desk rule. Despite the name, the backend scopes this by rule configuration, not strictly by desk type.
`quantity_available_inventory`	Allows a resource to accept multiple simultaneous bookings up to a configured quantity. Useful for inventory-style resources or shared-capacity items.
`booking_start_end_time`	Restricts bookings to allowed times. It supports flexible start/end windows and named shifts. The backend validates that the booking fits inside one allowed window.
`auto_cancellation`	Does not block booking creation. It schedules an auto-cancel job for some time after the booking starts if the user has not checked in.
`overflow_space`	Prevents booking this resource until another space reaches a configured utilisation percentage. Example: only allow overflow room bookings once main space occupancy is above 80%.
`book_on_behalf`	Limits how many bookings a user can create per day on behalf of other people. Supports a default limit plus team-specific overrides.

Important Behaviour Notes
On booking creation, most rules are enforced: duration, leadtime, buffers, advance booking, concurrent desks, quantity/inventory, booking start/end time, book-on-behalf, and overflow space.