1. Guesty Help Center
  2. Communications
  3. Communication Management
  4. Managing communications

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


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

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 notes

Cancellation policy 

{{direct_cancellation_policy_name}}

Currently only supported for direct reservations or reservations made via Guesty's Booking Engine

Cancellation fee 

{{direct_cancellation_fee}}

Part of the cancellation policy. Currently only supported for direct reservations or reservations made via Guesty's Booking Engine
Check-in date {{checkin}} The date will be based on the listing's time zone.
Check-out date {{checkout}} The date will be based on the listing's time zone.

Guest first name

{{guest_first}}

  

Guest flight number

{{flight_number}}

The guest's flight number

Guest full name

{{guest}}

The guest's full name
Guest planned arrival time {{planned_arrival_time}}

Either the estimated time of arrival the guest submitted or the listing's default check-in 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 {{planned_departure_time}}

Either the estimated time of departure the guest submitted or the listing's default check-out 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 transportation method {{transportation}} The guest's transportation from the airport to the property

Guest's email address

{{guest_email}}

The guest's email address

Guest's hometown

{{guest_hometown}}

The guest's hometown

Guest's phone number

{{guest_phone}}

The guest's phone number

Guest’s preferred language

{{guest_preferred_language}}

 

Guest’s identity number

{{guest_identity_number}}

 

Number of adult guests

{{adults_count}}

The number of adults in the reservation

Number of children guests

{{children_count}}

The number of children in the reservation

Number of guests

{{guests_count}}

The number of guests in the reservation. Counts adults only.

Number of infant guests

{{infants_count}}

The number of infants in the reservation

Number of nights

{{nights_count}}

The number of nights booked for the reservation

Reservation confirmation code

{{confirmation_code}}

The reservation's confirmation code

Listing’s door code

{{listing_door_code}}

An optional, additional code available for use, depending on the set up of your property

Listing’s lock code

{{listing_lock_code}}

An optional, additional code available for use, depending on the set up of your property

 

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, host, and check-in instructions

Variable

Placeholder to insert into message

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

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 listing's key code.

If you're using a third-party Marketplace partner, the placeholder will be populated with the same key code as in Guesty.

Listing check-in time

{{checkin_time}}

The time will be the listing's default check-in time, and be displayed in the listing's time-zone.

Listing check-out time

{{checkout_time}}

The time will be the listing's default check-out time, and be displayed in the listing's time-zone.

Listing nickname

{{listing_nickname}}

The nickname of your listing in Guesty

Listing title

{{listing}}

The title of your listing (as published on the channel)

Listing's check-in notes

 {{listing_checkin_instructions_notes}} The variable will be populated with info from the "Additional entry instructions" field / "What else do guests need to know to get inside" field in your listing's settings.

Listing's check-out instructions

 {{listing_checkout_instructions}} The variable will be populated with info from the "Check- out instructions (Optional)" field in your listing's settings.

Listing's city

{{listing_address_city}}

The city where the listing is located

Listing's cleaning instructions

{{listing_cleaning_instructions}}

The cleaning instructions

Cleaning instructions are entered in the listing's "Location and details" tab under "Details & Layout".

Listing's full address

{{listing_address}}

The complete address of your listing.

This includes the following optional fields:

  • County
  • Neighborhood
  • Unit
  • Apartment
  • Floor

 

Listing's luggage storage

{{listing_luggage_storage}}

The variable will be populated with info from the "Luggage storage (Optional)" field in your listing's settings. 

Listing's host name

{{listing_host_name}}

 

Listing's wifi name

{{listing_wifi_name}}

  

Listing's wifi password

{{listing_wifi_password}}

  

Listing's check-in and check-out instructions

 {{listing_checkin_instructions_notes}} This is for your listing's check-in/check-out policy for entering the property.

The variable will be populated with info from "What else do guests need to know to get inside" field in your listing's settings.

Listing's house manual

{{listing_house_manual}}

 

Listing's trash collected on instructions

{{listing_trash_collected_on}}

 

Listing's parking instructions

{{listing_parking_instructions}}

 

Listing’s building name

{{listing_address_building_name}}

 

Property size in square feet

{{property_size_square_feet}}

 

 

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

 

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 15 minutes after the reservation is created.

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 are variables created by Guesty to help you provide your staff with important information regarding next reservations.

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:

Was this article helpful?
0 out of 0 found this helpful