Guest booking experience

This guide walks through every guest-facing screen and flow on your reservation page — from landing and browsing packages, to booking, paying, receiving confirmation, modifying, and cancelling — plus the alternative party/event inquiry flow for groups that don't fit instant booking.

The reservation page — venue selection and package browsing

This page covers what guests see when they land on your public reservation page — from venue selection through choosing a package and time slot.

Landing page — Select Location

If your account has multiple venues, guests land on `/select-location` first. This screen shows a full-bleed background image (set via Home Background Image in your venue settings) with three input fields stacked vertically:

1. Select Location — dropdown listing all venues. Venues marked "Coming Soon" appear in the list but cannot be selected.

2. Number of Guests — dropdown from 1 to the selected venue's max guest count. If the guest exceeds the maximum, they are redirected to the event inquiry form.

3. Continue — validates a venue is selected, then loads the package browsing page for that venue.

If your account has only one venue, guests skip this screen entirely and land directly on the package page.

### How the title works

The heading displayed above the dropdowns is the Home Title field from your UI settings. It renders in white, bold text over the background image.

Package browsing page

After selecting a venue (or landing directly for single-venue accounts), guests see the main reservation page at `/package`. This page has three sections: a header area, the package list, and a sidebar summary (desktop only).

### Venue header

• Desktop: The venue's Packages Title and Packages Description appear as text at the top.

• Mobile: A large hero image (the venue image) fills the top of the screen. If the venue has a gallery, a View All button appears over the image.

### Tabs

Below the header, horizontal tabs let guests switch between:

The tab label text is configurable per venue (Packages Tab Name, Event Inquiry Tab Name, Custom Tab Name).

### Date picker

Directly below the tabs, a Select Date field lets guests choose their reservation date. Tapping it opens an inline calendar. Available dates are highlighted based on the venue's availability schedule. Dates with no availability appear grayed out.

### Category filter tabs

If the venue has Package Tags configured, a horizontal row of filter buttons appears above the package cards. Guests tap a category to filter the list (e.g., "Bowling", "Parties", "VIP").

The filter row scrolls horizontally when there are more tags than fit on screen. On desktop, left/right arrows appear at the edges.

### Package cards

Each package renders as a card with an image on the left (or top on mobile) and details on the right:

Contact-only packages show a "Contact Us" button instead of the expand button. The button text is customizable per venue.

Member-only packages show a "Sign In" button if the guest is not signed in with an eligible membership.

### Expanded package view

Tapping the "+" button (or tapping the card) expands it to reveal:

1. Full description — the package's rich-text description rendered as HTML.

2. Reservation Details section (heading is customizable) with form fields:

- Select Date — same calendar picker as the header, scoped to this package.

- Guests — dropdown from the package's min to max guests. Selecting a count above max redirects to the event inquiry form.

- Duration — only visible if Duration Choice is enabled. Shows the configured duration options.

- Resource quantity (e.g., "Lanes") — only visible if Show Resource Quantity is enabled. Label uses the package's resource name.

3. Age group selection — for age-group-based pricing packages, a guest age breakdown selector replaces the standard Guests dropdown. Each age group has its own count picker.

4. Time slots — available start times displayed as a grid of buttons. Each button shows:

- Start time

- Price (unless Hide Price on Time Card is on)

- For age-group packages, "See Prices" with an info icon instead of a flat price

- Reservation end time (if Show Reservation Time is enabled)

5. No availability handling:

- If no times are available for the selected date, an orange alert banner reads: "At the moment, there's no online availability based on your selection."

- If Show Next Available Times is enabled, the system displays time slots from the next dates that do have availability, grouped under date headings like "Wednesday, Mar 28."

6. 21+ age policy checkbox — if the selected time slot has a 21+ restriction, a checkbox appears requiring confirmation before continuing.

7. Continue button — enabled only when a valid date, guest count, and time slot are selected. On mobile, this button is fixed to the bottom of the screen.

### Sidebar summary (desktop only)

On desktop, a right-side panel shows:

### Mobile experience

On mobile:

Loading states

While venue data or package lists are loading, skeleton placeholder cards appear — matching the card layout with gray animated blocks for the image, title, price, description, and action row.

Booking a package — full flow

The package booking page is the main reservation experience guests see when they visit your booking link. It walks them through selecting a package, choosing a time slot, entering their details, and paying.

The booking flow's per-step routes

After selecting a package and time slot, guests move through a multi-step booking flow at `/reservation-info`. A progress indicator (desktop only) shows where they are. Each step is a separate route under `/reservation-info/`.

Steps in the booking flow

• Guest checkout — enter email only (unless disabled by the venue). This is the default if `defaultToGuestCheckout` is enabled.

• Create account — full registration with email, password, first name, last name, and phone.

• Sign in — email and password. A "Forgot password" recovery flow is available.

• Phone login — sign in via phone number (modal).

Guest checkout can be disabled per venue. The "Create account" option can also be hidden.

• Activity cards show name, image, description, and available time slots.

• Required activities are marked with a red asterisk. The guest cannot proceed without selecting all required activities.

• Duration and lane count selectors appear when the activity allows guest choice.

• An order summary sidebar (desktop) updates in real time.

• Add-ons display in a grid with image, name, price, and description.

Contact Details (always shown):

Guest Details (shown per package configuration):

Additional Info (shown per package configuration):

Notes — a free-text area if the venue enables custom notes. Can be required and pre-filled with default text.

On desktop, an order summary sidebar shows the booking details, price, and an edit button.

If the deposit is $0 (fully covered by gift cards or coupon codes), the guest sees a "Complete Reservation" button with no payment form. Venue policies display as a checkbox the guest must accept (if enabled). Gift card and coupon code inputs appear if enabled for the venue.

Checkout field reference

The Reservation Details screen collects guest information before payment. Fields are grouped into sections. Some sections only appear when enabled in your venue or package settings.

Fields

Contact Details (always shown)

Guest Checkout (email capture — shown when not signed in)

Guest Details (shown when package has guest-level custom fields enabled)

Additional Info (shown when package or venue has custom questions or fields enabled)

Address (shown when the Address custom field is enabled)

Notes (shown when Custom Notes is enabled on the venue)

Notes

- Fields marked Configurable are only shown when enabled in your venue or package configuration in the admin dashboard.

- Mandatory custom fields are enforced on submit — the guest cannot proceed without filling them in.

- For Steltronic integrations, the number of player detail entries always matches the guest count selected during package selection.

Party or event inquiry (non-instant booking)

The party/event inquiry page lets guests request a booking for group events like birthday parties, corporate outings, or private gatherings. This is not an instant booking — it submits a request that the venue reviews and follows up on.

The page uses a tabbed layout. The Contact Us tab (or whatever the venue has named it) is selected by default when guests land on the `/party` route. The other tabs link to standard reservation packages and an optional custom tab.

Pick a venue from the Location dropdown. Only open venues appear (no "Coming Soon" locations). Select the event type from the What's the Occasion? dropdown — options are configured by the venue (e.g., Birthday, Corporate Event, Holiday Party).

Pick the event date. The calendar shows availability based on the selected venue. After selecting a date, the calendar closes and the field updates.

Start times are generated in 30-minute intervals based on the venue's operating hours for the selected date. Duration options are preset (e.g., 1 hour, 1.5 hours, 2 hours, etc.).

The venue may enforce a minimum or maximum. If the count is outside the allowed range, an error message appears (e.g., "Guest number should be less than 50").

All four are required. Email and phone are validated — an invalid format triggers an inline error. A checkbox labeled "Keep me updated on exclusive offers and events" (or custom text set by the venue) is pre-checked by default unless the venue has configured it otherwise.

If the venue has added a note (e.g., deposit policy or cancellation terms), it appears below the checkbox.

The form sends all event details plus contact information to the venue. Google Analytics tracking parameters (UTM source, medium, campaign, etc.) are captured automatically if present. On success, the guest is redirected to the confirmation page.

What guests see after submitting an event inquiry

After a guest submits an event inquiry through the party booking form, they land on the confirmation page (`/thank-you`). This page confirms the request was received and displays a summary of the submitted details.

What guests see

The page shows a centered confirmation card with the following elements, top to bottom:

1. Thank-you icon — a decorative graphic at the top of the card.

2. "Request submitted" label and "Thank You" heading.

3. Confirmation title — defaults to "Thank you for inquiring about a party!" but can be customized per venue via the `eventConfirmationPageTitle` setting.

4. Confirmation copy — if the venue has set custom copy (`eventConfirmationPageCopy`), it renders here as rich HTML. Otherwise, the default message reads: *"We've received your event request and will reach out shortly to plan your next event."*

5. Guest's email address — displayed in bold so the guest knows where to expect a follow-up.

6. Venue name — shown as a clickable link to the venue's location URL (e.g., Google Maps or the venue's website).

7. Event summary — five detail lines:

- Occasion (e.g., Birthday, Corporate Event)

- Event Date (formatted as a readable date)

- Event Start Time (in 12-hour or 24-hour format based on venue settings)

- Event Duration (e.g., "2 hours")

- Number of Guests

8. "Go Back to Homepage" button — links to the venue's configured homepage URL.

On desktop, the right sidebar shows venue details (name, address, contact info). On mobile, the layout is single-column with no sidebar.

The confirmation email

Every completed booking triggers an automatic confirmation email to the guest's email address.

What the confirmation email includes

• Venue name and address
• Package name and description
• Date and time of the reservation
• Number of guests
• Resources assigned (lanes, bays)
• Total charged and payment breakdown
• Add-ons ordered
• Cancellation policy
• Manage Reservation link (to modify or cancel)
• Add to Calendar button (if enabled)
• Waiver signing link (if required)

Enable add-to-calendar buttons on the confirmation email

Enable the add-to-calendar button on confirmation emails so guests can save their reservation to their personal calendar.

Paying an outstanding balance on an existing reservation

Guests who owe an additional balance on a reservation receive a payment link. The /pay-reservation page loads the reservation and presents the venue's payment form.

How guests modify a reservation

Guests can modify their own reservations through the confirmation email link, as long as your venue allows self-service modifications.

How guests cancel a reservation

Guests can cancel their own reservations through the confirmation email link, subject to your cancellation policy.