Booking Engine provides a variable system that allows you to create dynamic and personalized URLs within text boxes by embedding reservation-specific data directly into your links.
Understand hyperlink variables
Hyperlink variables act as placeholders that Guesty automatically replaces with actual reservation details when displayed to guests. This feature helps you create customized hyperlinks containing personalized information without any manual work on your part.
Variables are inserted using curly braces: {variableName}
For example, you can create a payment link that automatically includes the guest's reservation ID and the total booking amount, saving you time and reducing the risk of manual errors
Here's how a URL with variables typically looks:
https://example.com/payment?reservationId={reservationId}&amount={amount}
Available variables
You can use the following variables in your booking engine hyperlinks:
- {reservationId}: The unique identifier for the reservation. Example: "RES-12345"
- {amount}: The total booking amount. Example: "1250.00"
- {guestName}: The full name of the guest. Example: "John Smith"
- {listingName}: The name of the property. Example: "Beach House Villa"
- {listingId}: The unique identifier for the listing. Example: "5f8d0d55b54764421b71614a"
- {checkIn}: The check-in date in YYYY-MM-DD format. Example: "2023-06-15"
- {checkOut}: The check-out date in YYYY-MM-DD format. Example: "2023-06-20"
How variables are resolved
Guesty handles all the variable replacement automatically when a guest views a text box containing a hyperlink with variables.
Original URL with variables (example):
“https://example.com/payment?reservationId={reservationId}&amount={amount}&guestName={guestName}&listingName={listingName}&listingId={listingId}&checkIn={checkIn}&checkOut={checkOut}”
Resolved and encoded URL (example):
“https://example.com/payment?reservationId=RES-12345&amount=1250.00&guestName=John%20Smith&listingName=Beach%20House%20Villa&listingId=5f8d0d55b54764421b71614a&checkIn=2023-06-15&checkOut=2023-06-20”
Notice how all variables are replaced with actual reservation information and properly encodes values containing spaces (e.g., "John Smith" becomes "John%20Smith").
- All variable names are case-sensitive. Always use the exact capitalization shown in our variables tables (e.g., `{reservationId}` works, but `{reservationid}` doesn't).
- Variable replacement happens automatically when the link is displayed to guests. You don't need to perform any additional steps.
- If you include an invalid variable or one without corresponding reservation data, that variable will remain unchanged in the URL. Always verify your variable names for accuracy.
By incorporating these hyperlink variables into your booking engine text boxes, you can:
- Create personalized payment links that include the exact amount due
- Generate custom check-in instructions with property-specific details
- Develop feedback forms pre-populated with reservation information
- Build guest experience surveys that reference the specific property