Personalize your communication with guests, owners, and team members using variables. Variables act as placeholders that automatically fill in specific details—like a guest's name, key code, or check-in time—when a message is sent. This helps you provide accurate, relevant information without manually editing every message.

You can add variables to the following communication methods:

Guesty automatically replaces each variable with the relevant information when the message triggers. See the 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

Below is a list of available variables and their values. You can use the default variables listed below, or create custom variables by adding a new custom field, which automatically generates a custom variable.

Important:

  • If you add a variable incorrectly, the message will fail. Ensure variables are spelled correctly and don't contain additional characters or spaces.
  • If you see unexpected values when using variables, check your settings first. For example, verify your financial or availability settings, or check if a team member has recently made changes.

Custom variables 

Use custom variables to send specific information not covered by default variables. When you create a custom field, Guesty automatically generates a custom variable. You can find these in the "Variable" column of the custom fields page.

For example, if you create a custom field like "Building Name", a variable like {{buildingname}} is generated. 

When you add a custom variable to a message, the relevant custom field value updates automatically when sent. 

You must set up the custom fields via the "Properties" page or the "Reservations" page before using the variable in a message.  If a custom field isn't working, check the following:

Tip:

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

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}}

Displays the date based on the listing's time zone.

Learn how to change the dates of the reservation.

Check-out date {{checkout}}

Displays the date 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 includes both adults and children.

Manual reservations: Includes adults only—children aren't counted in.

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.
Signed PDF Agreement {{guest_app::[app_name]::pdf}} Copy of signed PDF agreement to guest.
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.

Guest invoice {{guest_invoice}}

Send the guest invoice as an attachment.

Note:

This variable is not supported for saved replies.

Reservation accommodation fare {{fare_accommodation}} The net accommodation fare, excluding fees or taxes.
Reservation accommodation fare - adjusted {{accommodation_fare_adjusted}}

The net accommodation fare that has been adjusted, excluding fees or taxes. 

Note:

This variable is not supported for saved replies.

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}} 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 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).
Guesty commission {{our_commission}} Guesty's commission for the reservation if the user’s billing plan is a revenue-based percentage.
Host channel fee {{host_service_fee}} The channel fees (only for the listing).
Host taxes {{host_taxes}}

The sum of the taxes + pre-deducted channel commission.

Only applicable for "airbnb", "airbnb2", and "tripAdvisor". 

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}}

The name of the rate plan.

Learn about managing rate plans.

Rate plan description {{direct_rate_plan_description}}

The description of the rate plan.

Learn about managing rate plans.

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).

Next reservation variables

Use these variables to share information with your staff about the next reservation on the calendar (the reservation immediately following the current one).

For example:

To inform your cleaner when the next check-in is planned for, 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.

Next reservation variables

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.
Was this article helpful?
1 out of 2 found this helpful