Weekly Grid Settings (Facility Owner / Admin)
Overview
For facilities configured in hourly mode, the Weekly Grid is shown to guests by default. This page explains the admin-side settings that affect how the grid is displayed and how bookings are constrained.
Detailed Features
Feature 1: Minimum Booking Duration
Each plan can have a minimum booking duration. The available options are:
| Value | Meaning |
|---|---|
| 15 min | Bookings must be at least 15 minutes |
| 30 min | Bookings must be at least 30 minutes |
| 60 min | Bookings must be at least 60 minutes |
| 90 min | Bookings must be at least 90 minutes |
| 120 min | Bookings must be at least 120 minutes |
This setting also influences the grid cell granularity. For example, a 90-minute minimum causes the grid to render at 30- or 60-minute intervals, and any end-time cell that would result in a shorter booking is shown with a stripe pattern (faded, not tappable).
Where to configure: Plan edit screen → Hourly settings section
Feature 2: Business Hours (Per-Day Configuration)
The Weekly Grid reads the per-day business hours registered in the facility's BaseSettings.
- Each day of the week can have a different open/close time (e.g., Saturday 10:00–18:00, weekdays 09:00–22:00)
- Cells outside the day's business hours are rendered with a stripe pattern and cannot be tapped by guests
Important: The per-plan
business_hoursfield is scheduled for removal in a future release. Manage operating hours exclusively through the facility's BaseSettings.
Where to configure: Facility Settings → Base Settings → Business Hours
Feature 3: Booking Lead Time (formerly "Minimum Booking Hours")
The host-side configuration includes a field labeled "Booking Lead Time (h)". This is the advance booking notice period — how many hours before a slot a guest must book.
Example: Setting lead time to 2 means guests can only book time slots that start at least 2 hours from now (prevents last-minute bookings).
Note: This is distinct from Minimum Booking Duration. Lead time controls how far in advance a booking must be made; minimum duration controls the length of the booking itself.
Where to configure: Plan edit screen → Booking Lead Time (h)
Feature 4: time_slot_week_grid Flag (v2 New — Opt-in)
time_slot_week_grid is an opt-in flag that enables the weekly grid layout for time slot plans.
| Item | Details |
|---|---|
| Default | Off (legacy time slot list is shown) |
| Target facilities | Facilities with time slot type plans |
| Sunset date | 2026-12-01 (planned default-on after this date) |
| Flag changes | Made by platform administrators per facility |
Recommended candidates for enabling:
- Facilities with high time slot booking volume (Morning Session / Afternoon Session etc.)
- Facilities receiving guest feedback asking to compare availability across multiple days
- Facilities with a predominantly mobile audience comfortable with swipe navigation
Once enabled, guests see each tier as a rounded block across a 7-day grid on the confirmation screen.
Feature 5: Automatic Tier Breakdown on Confirmation Screen (v2)
When hourly_rate_tiers is configured with time-of-day rates (Morning, Afternoon, Late Night pack, etc.), the itemized tier breakdown is shown automatically on the guest confirmation screen. No additional admin toggle is required.
- The
max_daily_feecap is now correctly reflected in the customer-facing breakdown (bug fix bundled in v2 Phase A). - Facilities without
hourly_rate_tierscontinue to show the single-line rate × hours display.
Where to configure: Plan edit screen → Hourly settings → Time-of-day rates (hourly_rate_tiers)
Feature 6: Legacy Flag (hourly_time_bar)
In earlier versions, the hourly_week_grid feature flag was used to opt into the weekly grid. The grid is now on by default for all hourly facilities.
hourly_week_gridflag: deprecated — no longer has any effecthourly_time_barflag: use this only if you want to revert to the legacy start/end dropdown form
When to use
hourly_time_bar: Enable this flag only if the dropdown format is a better fit for your guests, or if you are running a phased rollout and want to keep the legacy UI temporarily.
Flag changes are made by platform administrators.
Frequently Asked Questions
Q: Can I disable the Weekly Grid and return to the old screen?
Yes. Ask your platform administrator to enable the hourly_time_bar flag for your facility. Once enabled, guests will see the legacy start/end dropdown form.
Q: How do I set different hours for Saturday vs. weekdays?
Go to Facility Settings → Base Settings → Business Hours and configure open/close times for each day individually. The Weekly Grid automatically reads these per-day settings and renders out-of-hours cells with a stripe pattern.
Q: What does the grid look like after I set a minimum booking duration?
End-time cells that would result in a booking shorter than the configured minimum are displayed with a stripe pattern (faded) and cannot be tapped. For a 90-minute minimum, any end cell within 90 minutes of the selected start time will be shown this way.
Q: When should I enable time_slot_week_grid?
Enable it for facilities where time slot bookings (Morning / Afternoon sessions, etc.) are frequent and guests would benefit from seeing multi-day availability at a glance. Facilities with only one time slot per day, or where guests navigate the existing list format without difficulty, are unlikely to see significant UX gains before the flag becomes default-on at Sunset (2026-12-01). Contact your platform administrator to enable it.
Q: What is the difference between "Booking Lead Time" and "Minimum Booking Duration"?
| Setting | Meaning | Example |
|---|---|---|
| Booking Lead Time (h) | How far in advance a booking must be made | 2 → only slots starting 2+ hours from now are bookable |
| Minimum Booking Duration | The shortest allowed booking length | 90 min → bookings under 90 minutes are not allowed |