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:

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_hours field 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 Plans Also Use the Weekly Grid

Time slot plans (Morning Session, Afternoon Session, etc.) are shown on the weekly grid as well (the time_slot_week_grid flag is on by default in production). Nothing needs to be enabled on the facility side.

• On the guest's time selection screen (Step 2), each time slot appears as a tall block in a 7-day grid
• Guests simply tap a block to choose the whole time slot
• The legacy "pick a date, then see that day's list of time slots" screen no longer appears in the new booking flow

For the guest's view, see Time Slot Booking (Guest).

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_fee cap is now correctly reflected in the customer-facing breakdown (bug fix bundled in v2 Phase A).
• Facilities without hourly_rate_tiers continue to show the single-line rate × hours display.

Where to configure: Plan edit screen → Hourly settings → Time-of-day rates (hourly_rate_tiers)

Night pack prices may change. Until now, a configured night pack was never applied by the billing calculation — the simulation panel did reflect it, so the simulated total and the actual charge disagreed. The night pack is now actually applied, so plans that already have one configured will bill differently for late-night hours. Re-check the numbers in the simulation panel on Price Plan Settings.

How day of week and holidays are determined. The Weekday / Weekend / Holiday checkboxes on rate tiers (hourly_rate_tiers) and the Weekend/Holiday rate are resolved automatically from the civil date in the facility's timezone and the public holiday calendar for the facility's country. A booking starting between 00:00 and 09:00 JST is billed under the correct day. See Price Plan Settings — How Day-of-Week and Holiday Rates Are Chosen.

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_grid flag: deprecated — no longer has any effect
• hourly_time_bar flag: 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 support.

---

Frequently Asked Questions

Q: Can I disable the Weekly Grid and return to the old screen?

Yes. Ask support 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: Do I need to enable the weekly grid for time slot plans?

No. The weekly grid for time slot plans is on by default in production. No facility setting or support request is needed.

Q: What is the difference between "Booking Lead Time" and "Minimum Booking Duration"?

---

Related Pages

• Weekly Grid Hourly Booking (Guest)
• Plan Configuration
• Base Settings
• Booking Management Dashboard
• Sales Blocks - Which grid cells a time- and day-of-week-limited sales block closes