Guest Portal (Check-In PWA)

Common Tasks

How to Send a Guest Portal Link to a Guest (Generate Portal Link, Send Check-In Link)

Staff generate a secure link and send it to the guest so they can complete check-in online.

1. Go to Reservations and open the reservation
2. Click the Guests tab
3. Click the button Generate Guest Portal Link (or, if a link was already generated, the button shows View Guest Portal Link). The button has a link icon; label may show "Generating..." while loading
4. A modal opens titled Guest Portal Link with description: "Share this link with your guest to complete check-in information for all travelers. Enter the email address and send, or copy the link to share manually."
5. Copy the link using the Copy button, or enter an email in Send to Email and click Send via Email

Result: The guest receives the link (e.g. /consumer/check-in/[token]) and can complete the check-in wizard. Data is submitted to the reservation; staff see it in the reservation and at the Front Desk.

What the Guest Sees: Check-In Wizard Steps

When a guest opens the portal link they land on a Welcome page showing reservation dates, accommodation, and guest count. They click Let's Get Started to begin. The exact flow:

1. Guest Count — Page titled "How many guests?" with subtitle "Tell us who's checking in". Guest enters number of adults and children (and child ages). Then continues to the first guest's steps
2. For each guest (one at a time):
   • Scan — Document scan (passport/ID); can skip to manual entry
   • Details — Personal details (name, date of birth, nationality, etc.)
   • Contact — Phone and email
   • Requests — Special requests (dietary, accessibility, room preferences, other)
3. Review — Review all guests and data before submitting
4. Success — Confirmation that check-in information was submitted

Result: Submitted data is stored against the reservation. Staff can view it in the reservation and use it at the Front Desk for a faster in-person check-in.

How a Guest Installs the Guest Portal as an App (PWA Install)

The Guest Portal can be installed as a Progressive Web App (PWA) on the guest's device for a full-screen, app-like experience.

1. Guest opens the portal link in a supported browser (e.g. Chrome, Safari on iOS)
2. If an install banner is shown (e.g. "Install Guest Portal"), tap Install (or use the browser menu → Add to Home Screen / Install App)
3. Complete the check-in steps in the installed app

Result: The guest has an icon on their home screen; opening it goes straight to the portal (or to their reservations if they have an account). Same flow works in the browser without installing.

How a Guest Views Their Reservations (Logged-In Consumer)

If the guest has signed in (e.g. via the Consumer app with phone/email OTP), they may see a list of their reservations and can open the check-in link from there.

1. Guest signs in to the consumer/guest experience (e.g. Consumer PWA or guest portal entry point)
2. Go to Reservations (or My Trips / My Bookings)
3. Tap a reservation to open it
4. If check-in is available, tap Check In or the guest portal link to start the check-in wizard

Result: They complete the same check-in flow as when opening the link directly from email.

Key Concepts

Guest Portal vs Consumer PWA (Dine and Shop)

Guest Portal (this feature): Used for resort/hotel pre-arrival check-in. Guests use a token-based link, complete documents and details, and submit to the reservation. Can be installed as a PWA. Consumer PWA: Used for discovering and ordering from restaurants (Dine) and shops (Shop), at-table QR ordering, cart, bill split, profile. Different entry points and URLs. See Consumer PWA for the latter.

Token-Based Link

Each guest portal link contains a unique token. The token is tied to the reservation (and possibly the guest). Old URLs (e.g. /guest-portal/[token]) may redirect to the new path /consumer/check-in/[token]. QR codes for guest check-in typically encode this URL so guests can scan and open the portal.

Troubleshooting

Guest Says Link Does Not Work

Cause: Expired or invalid token, wrong URL, or reservation cancelled.

Fix: In Reservations → reservation → Guests, generate a new Guest Portal Link and send it again. Confirm the reservation is still confirmed and the link was copied in full.

Check-In Data Not Appearing in Reservation

Cause: Guest may not have completed all steps or submitted; or a sync/display delay.

Fix: Ask the guest to open the link again and complete through to the Success step. Refresh the reservation in the staff app and check the Guests tab and any "Guest portal data" or document sections.