Which variables can I add to an automated message?

You can add variables to Automated Messages, and personalize the message to match your guest and their reservation. 

Read more below about which variables are available to you and how they are populated when the 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

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

Number of adult guests

{{adults_count}}

The number of adults on the reservation

Number of children guests

{{children_count}}

The number of children on the reservation

Number of guests

{{guests_count}}

The number of guests on the reservation

Number of infant guests

{{infants_count}}

The number of infants on 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

 

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

 

 

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

{{NRI}}

All fees and charges that were set in the business model as “net rental income” (commission calculation).

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 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 (explained above).

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.

 

Next reservation variables

These are more variables created by Guesty to help you provide your staff with important information regarding upcoming 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 Auto Message: 

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

"Next reservation" variable options Below are the upcoming reservation variables you can choose in Guesty.

Variable

Placeholder to insert into message

What info will be displayed in the sent message?


Additional notes

Check-in date

{{next::checkin}}

The check-in date for the next reservation

The date will be based on the listing's time zone.

Check out date

{{next::checkout}}

The check-out date for the next reservation

The date will be 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}}

Either the estimated time of arrival for the next guest that they 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

{{next::planned_departure_time}}

Either the estimated time of departure for the next guest that they 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'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

The fee will be displayed as a percentage (%).

Host channel fee

{{next::host_service_fee}}

The channel fees of the next reservation.

Channel fees will be for the specific listing only.

Listing check in time

{{next::checkin_time}}

The next reservation's check-in time The time will be based on the listing's time zone.

Listing check out time

{{next::checkout_time}}

The next reservation's check-out time The time will be 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

This doesn't include 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?
0 out of 0 found this helpful