Last verified: 2026-05-19
Reservations (admin)
Manage table/venue reservations, configure booking policies, and track guest status through the reservation lifecycle.
Feature gate
Restaurant tenants typically require subscription feature enableTableReservations. Service businesses may see Appointments instead of reservations.
Dashboard paths
| Area | Route |
|---|---|
| Reservation list | /admin/reservations |
| Reservation settings | /admin/reservations/settings |
| Staff mirror | /staff/reservations, /staff/reservations/settings |
Page titles (by business type)
| Business type | List title | Description |
|---|---|---|
| Restaurant (default) | Reservations Management | View and manage restaurant reservations, bookings, and scheduling |
| Service | Appointments | Manage customer appointments and service bookings |
In-client header (restaurant): Reservations — Manage restaurant reservations and bookings.
Settings page (server): Reservation Settings — Configure reservation policies and durations.
Reservation statuses
| Status | Meaning |
|---|---|
| PENDING | Awaiting confirmation |
| CONFIRMED | Accepted |
| SEATED | Guest arrived / seated |
| COMPLETED | Finished |
| CANCELLED | Cancelled |
| NO_SHOW | Guest did not arrive |
List view — stats & actions
Summary cards:
- Total Reservations
- Today's Reservations
- Confirmed
- Pending
Actions:
- Settings →
/admin/reservations/settings - New Reservation — create booking from admin UI
Filters
| Filter | Notes |
|---|---|
| Search | Placeholder: Name, email, phone... |
| Status | All Statuses, Pending, Confirmed, Seated, Completed, Cancelled, No Show |
| Date | Filter by reservation date |
| Location | Sub-organization / branch filter |
Table shows guest, party size, scheduled time, table number, location, status badge, and Edit Reservation.
Steps — manage a reservation
- Open
/admin/reservations. - Find the booking via search, date, or status filters.
- Open the row menu → Edit Reservation (or create via New Reservation).
- Update status (e.g. PENDING → CONFIRMED → SEATED → COMPLETED) per your service flow.
- Mark NO_SHOW or CANCELLED when appropriate.
Reservation settings
Open /admin/reservations/settings. Header: Reservation Settings — Configure party size durations and reservation policies.
Tabs
| Tab | Purpose |
|---|---|
| Organization Settings | Defaults for all locations |
| Location Overrides | Per-branch overrides |
Organization-wide defaults
Card: Organization-Wide Defaults — Set default reservation settings that apply to all locations unless overridden
Actions:
- Reset to Defaults
- Save Organization Settings (enabled when there are unsaved changes)
Success toast: Organization reservation settings have been updated successfully.
Location overrides
Card: Location-Specific Settings — Override organization defaults for specific locations
Select a location, then adjust settings. Actions:
- Reset to Org Defaults
- Reset to System Defaults
- Save location settings
Success toast: Location reservation settings have been updated successfully.
Key settings fields
| Setting | Typical default | Purpose |
|---|---|---|
| Party size durations | 1–8 guests mapped to minutes (e.g. 2 guests = 45 min) | Seating time by party size |
| Default reservation duration | 90 min | Standard booking length |
| Max reservation advance days | 30 | How far ahead guests can book |
| Reservation buffer minutes | 15 | Gap between bookings |
| Allow online reservations | true | Public storefront booking |
| Require reservation deposit | false | Deposit policy |
| Grace period minutes | 15 | Late arrival grace |
| Cancellation hours | 24 | Free cancellation window |
| Credit card required | false | Card hold for no-show protection |
| No-show charge per person | optional | Fee policy |
Section heading in UI: Party Size Duration Logic
Customer / storefront booking
- Customers manage bookings at
/customer/reservations. - Public booking may be available at
/store/{slug}/.../reservationswhen Allow online reservations is enabled.
Verify it worked
- Test reservation appears in list with correct status and time.
- Online booking respects advance days and party-size duration.
- Location override changes only affect the selected branch.
Vertical notes
- Hotel: List page may use bookings terminology; room reservations tie to hotel modules.
- Service: Uses Appointments client instead of standard reservations table.
Common issues
| Symptom | Likely cause | What to do |
|---|---|---|
| Module missing | enableTableReservations off plan | Upgrade subscription |
| No online bookings | allowOnlineReservations false | Enable in org or location settings |
| Wrong duration | Party size map | Edit Party Size Duration Logic |
