Using variables in messages

This article is relevant for:

You can add variables to automated messages, saved replies, manual messages, messages using ReplyAI, and auto responses (Pro users) to personalize your communication.
Each variable acts as a placeholder that is automatically replaced with the relevant information when the message is triggered. See an example below.

Automated message template	How the message is sent
Hi {{guest}}, We are pleased to welcome you today to our Luxury Apartment {{listing_address}}. Your key code to access the property is {{key_code}}. {{listing_checkin_instructions_notes}} Let us know if you have any questions. Regards, {{host_first}}	Hi Jill Ross, We are pleased to welcome you today to our Luxury Apartment 123 Riverside Lane, Apartment 4. Your key code to access the property is 1234. Check-in is at 3pm. There is free street parking available. When you arrive, enter the above key code then the check button. To lock the door press the X button. Let us know if you have any questions. Regards, Tim

Automated message template

How the message is sent

Hi {{guest}},

We are pleased to welcome you today to our Luxury Apartment {{listing_address}}. Your key code to access the property is {{key_code}}.

{{listing_checkin_instructions_notes}}

Let us know if you have any questions.

Regards,
{{host_first}}

Hi Jill Ross,

We are pleased to welcome you today to our Luxury Apartment 123 Riverside Lane, Apartment 4. Your key code to access the property is 1234.

Check-in is at 3pm. There is free street parking available. When you arrive, enter the above key code then the check button. To lock the door press the X button.

Let us know if you have any questions.

Regards,
Tim

Below is a list of available variables for messages and how they are populated when a message is sent.

Important:

If a variable is added incorrectly, the message will fail.
Ensure variables are spelled correctly and do not contain additional characters or spaces.

Default variables

These variables are created by Guesty, based on the needs and demands of the industry.

Reservation & guest details

Variable	Placeholder to insert into message	Additional details
Check-in date	{{checkin}}	The date will be based on the listing's time zone. Learn how to change the dates of the reservation.
Check-out date	{{checkout}}	The date will be based on the listing's time zone. Learn how to change the dates of the reservation.
Guest first name	{{guest_first}}	Learn how to update the guest details. Updating a guest’s details will change their details in all the reservations that they're assigned to, as well as, on their contact page.
Guest flight number	{{flight_number}}	Learn how to update the guest details. Updating a guest’s details will change their details in all the reservations that they're assigned to.
Guest full name	{{guest}}	Learn how to update the guest details. Updating a guest’s details will change their details in all the reservations that they're assigned to, as well as, on their contact page.
Guest planned arrival time	{{planned_arrival_time}}	The planned arrival time is the guest's estimated arrival time (if it was set), or the listing's default check-in time.
Guest planned departure time	{{planned_departure_time}}	The planned departure is the guest's estimated departure time (if it was set), or the listing's default check-out time.
Guest transportation method	{{transportation}}	Learn how to update the guest details. Updating a guest’s details will change their details in all the reservations that they're assigned to.
Guest's email address	{{guest_email}}	Learn how to update the guest details. Updating a guest’s details will change their details in all the reservations that they're assigned to, as well as, on their contact page.
Guest's hometown	{{guest_hometown}}	Learn how to update the guest details. Updating a guest’s details will change their details in all the reservations that they're assigned to, as well as, on their contact page.
Guest's phone number	{{guest_phone}}	Learn how to update the guest details. Updating a guest’s details will change their details in all the reservations that they're assigned to, as well as, on their contact page.
Guest’s preferred language	{{guest_preferred_language}}	Learn how to update the guest details. Updating a guest’s details will change their details in all the reservations that they're assigned to, as well as, on their contact page.
Guest’s identity number	{{guest_identity_number}}	Learn how to update the guest details.
Number of adult guests	{{adults_count}}	Learn how to update the age breakdown for manual and direct reservations.
Number of children guests	{{children_count}}	Learn how to update the age breakdown for manual and direct reservations.
Number of guests	{{guests_count}}	The number of guests in the reservation. Counts adults only. Learn how to update the number of guests in the reservation.
Number of infant guests	{{infants_count}}	Learn how to update the age breakdown for manual and direct reservations.
Number of nights	{{nights_count}}	Learn how to change the dates of the reservation.
Reservation confirmation code	{{confirmation_code}}	The reservation's confirmation code, as displayed at the top left of the reservation page.

Guest payment

Variable	Placeholder to insert into message	Additional notes
Currency	{{currency}}	The currency that the reservation should be paid in. The currency will be based on the listing's set currency.
Reservation accommodation fare	{{fare_accommodation}}	The payout for the reservation. This doesn't include fees or taxes.
Reservation balance due	{{balance_due}}	The balance of the reservation if it is still due to be paid.
Reservation cleaning fee	{{fare_cleaning}}	The reservation's cleaning fee.
Reservation payments	{{payments}}	The total amount paid by the guest and when they paid it.
Reservation taxes	{{reservation_taxes}}	The reservation's tax amount.
Reservation total paid	{{total_paid}}	The reservation's total amount paid.

Listing's settings, host information, and check-in instructions

Variable	Placeholder to insert into message	Additional notes
Listing’s door code	{{listing_door_code}}	Learn how to set the listing's check-in/check-out instructions.
Listing’s lock code	{{listing_lock_code}}	Learn how to set the listing's check-in/check-out instructions.
Cancellation policy	{{direct_cancellation_policy_name}}	Learn how to change a listing's cancellation policy.
Cancellation fee	{{direct_cancellation_fee}}	Learn how to change a listing's cancellation policy.
Check-in form link	{{checkin_form}}	This is for Pro users only. Learn more about check-in forms.
Guest access code	{{guest_access_code}}	The guest access code is generated per reservation by Guesty Locks Manager.
Host first name	{{host_first}}	Airbnb: The host's first name is taken from the name associated with the integration email address. Rentals United: The host's first name (as it appears on the connection). All other booking channels: The first name of the last/most recent user who responded to the guest via the Inbox. If a message is being sent to a guest for the first time, the placeholder's value will be the first user in your Guesty account's user list. The list is sorted alphabetically.
Host full name	{{host}}	Rentals United: The host's full name (as it appears on the connection). All other booking channels: The full name of the last user who responded to the guest via the Inbox. If a message is being sent to a guest for the first time, the placeholder's value will be the first user in your Guesty account's user list. The list is sorted alphabetically.
Key code	{{key_code}}	The guest key code is generated by a third-party Marketplace partner.
Listing check-in time	{{checkin_time}}	Learn how to change a listing's check-in time. Check-in time is displayed in the listing's time zone.
Listing check-out time	{{checkout_time}}	Learn how to change a listing's check-out time. Check-out time is displayed in the listing's time zone.
Listing nickname	{{listing_nickname}}	Learn how to change a listing nickname.
Listing title	{{listing}}	Learn how to change a listing's title (as published in your connected booking channels).
Listing's check-in notes	{{listing_checkin_instructions_notes}}	Learn how to set the listing's check-in/check-out instructions. The variable will be populated with info from the "Additional entry instructions" field in the reservation policies.
Listing's check-out instructions	{{listing_checkout_instructions}}	Learn how to set the listing's check-in/check-out instructions.
Listing's city	{{listing_address_city}}	The city where the listing is located. Learn how to update a listing address.
Listing's cleaning instructions	{{listing_cleaning_instructions}}	The variable will be populated with information from the "Location and details" section.
Listing's full address	{{listing_address}}	The complete address of your listing. This includes the following optional fields: County Neighborhood Unit Apartment Floor Learn how to update a listing address.
Listing's luggage storage	{{listing_luggage_storage}}	Learn how to set the listing's check-in/check-out instructions.
Listing's host name	{{listing_host_name}}	The variable will be populated from the "Guest should know" section, appearing in Details & layout >Location & details.
Listing's wifi name	{{listing_wifi_name}}	The variable will be populated from the "Guest should know" section, appearing in Details & layout >Location & details.
Listing's wifi password	{{listing_wifi_password}}	The variable will be populated from the "Guest should know" section, appearing in Details & layout >Location & details.
Listing's check-in and check-out instructions	{{listing_checkin_instructions_notes}}	The variable will be populated with info from "What else do guests need to know to get inside" field in your listing's settings. Learn how to set the listing's check-in/check-out instructions.
Listing's house manual	{{listing_house_manual}}	The variable will be populated with information from the "Guest should know" section, appearing in Details & layout >Location & details.
Listing's trash pick up instructions	{{listing_trash_collected_on}}	The variable will be populated with information from the "Guest should know" section, appearing in Details & layout >Location & details.
Listing's parking instructions	{{listing_parking_instructions}}	The variable will be populated with information from the "Guest should know" section, appearing in Details & layout >Location & details.
Listing’s building name	{{listing_address_building_name}}	The variable will be populated with information from the "Full address" section >"Additional address details". Learn how to update a listing address.
Property size in square feet	{{property_size_square_feet}}	The variable will be populated with information from Details & layout > Location & details > Property details.

Revenue & payouts

Variable	Placeholder to insert into message	Additional notes
Guesty fee	{{our_fee}}	Guesty's fee for the reservation (in USD).
Host channel fee	{{host_service_fee}}	The channel fees (only for the listing).
Net rental income	{{net_rental_income}}	All fees and charges that were set in the business model as “net rental income” (commission calculation).
Rate plan name	{{direct_rate_plan_name}}	Learn about managing rate plans.
Rate plan description	{{direct_rate_plan_description}}
Reservation host payout	{{host_payout}}	The host's final earnings from the reservation.
Reservation owner's revenue	{{owners_revenue}}	The owner's revenue from the reservation. The owner's revenue data will be available 1 hour after confirmation.
Reservation’s property manager commission	{{commission}}	The "your commission" figure from the reservation. Reservation's property manager commission data will be available 15 minutes after the reservation is created.

Staff

Variable	Placeholder to insert into message	Additional notes
Integration nickname	{{integration_nickname}}	The unique name for each of the user's connections (as it appears in Guesty).
Reservation channel	{{channel}}	The source of a reservation. This could be the booking channel or the source that is entered when creating a manual reservation in Guesty.
Reservation cleaning notes	{{notes_cleaning}}	The text in the reservation's "cleaning notes" field.
Reservation other notes	{{notes_other}}	The text in the reservation's "other notes" field.
.Team member first name	{{user_first}}	The user's first name (as it appears in Guesty).
Team member full name	{{user}}	The user's full name (as it appears in Guesty).

Custom variables (Pro users only)

A custom variable is generated when you create a custom field. The variable will automatically be added for a new custom field, and be displayed under the "Variable" column in the "custom fields" section of the Guesty dashboard.

When adding a variable to an automated message, select the relevant variable from the custom variables tab. The relevant custom field value will automatically be populated when the message is sent.

We recommend creating a custom variable for any information you find yourself sending repeatedly to guests that can't be found in the list of the default variables.

The relevant custom field must be populated (entered/filled in) before using it. If your custom field isn't working, it might be due to one of the reasons below:

The custom field in the property page or reservation page was not populated (entered/filled in)
The custom field was populated on the property or reservation page only after the message (or Auto Message) was sent.
The custom field contains a default variable or has another custom field in it.

Tip:

You can add custom fields with "Yes/No" field type as a sending condition by selecting them from the same dropdown under Add condition.

Next reservation variables

These default variables are designed to help you share important information with your staff about a reservation next to the current one on the Multi-Calendar and the listing’s calendar.

For example:
If you'd like to send a message to inform your cleaner when the next check-in is planned for, you can create this automated message:

Hi {{user}},
We are expecting the next guest on {{next::checkin}}. Please have the apartment ready by then.
Regards,
{{host_first}}

Below are the next reservation variables you can use in Guesty.

Variable	Placeholder to insert into message	Additional notes
Check-in date	{{next::checkin}}	The check-in date for the next reservation based on the listing's time zone.
Check out date	{{next::checkout}}	The check-out date for the next reservation based on the listing's time zone.
Guest first name	{{next::guest_first}}	The first name of the next guest.
Guest full name	{{next::guest}}	The full name of the next guest.
Guest planned arrival time	{{next::planned_arrival_time}}	If the guest's estimated arrival time was added to the reservation, that will be used. Otherwise, the listing's default check-in time will be used.
Guest planned departure time	{{next::planned_departure_time}}	If the guest's estimated departure time was added to the reservation, that will be used. Otherwise, the listing's default check-out time will be used.
Guest's email address	{{next::guest_email}}	The email address of the next guest.
Guest's phone number	{{next::guest_phone}}	The phone number of the next guest.
Guesty fee	{{next::our_fee}}	Guesty's fee for the next reservation displayed as a percentage (%).
Host channel fee	{{next::host_service_fee}}	The channel fees of the next reservation, specific to the listing only.
Listing check in time	{{next::checkin_time}}	The next reservation's check-in time based on the listing's time zone.
Listing check out time	{{next::checkout_time}}	The next reservation's check-out time based on the listing's time zone.
Number of guests	{{next::guests_count}}	The number of guests in the next reservation.
Number of nights	{next::nights_count}}	The number of nights booked for the next reservation.
Reservation accommodation fare	{{next::fare_accommodation}}	The payout for the next reservation, excluding fees or taxes.
Reservation cleaning fee	{{next::fare_cleaning}}	The next reservation's cleaning fee.
Reservation cleaning notes	{{next::notes_cleaning}}	The text in the next reservation's "cleaning notes" field.
Reservation confirmation code	{{next::confirmation_code}}	The next reservation's confirmation code.
Reservation guest notes	{{next::notes_guest}}	The text in the next reservation's "guest notes" field. The "Guest Notes" field under a reservation is meant for notes to share with the guest using this variable. The "Notes" field under a guest is meant for internal notes related to that guest (across all their reservations), and doesn't have a variable.
Reservation host payout	{{next::host_payout}}	The host's final earnings for the next reservation.
Reservation other notes	{{next::notes_other}}	The text in the next reservation's "other notes" field.

Related to:

GFP: Communication