Articles on: Outbound communications

Message tags

Message tags

Message tags put guest, booking and listing details into a message automatically, so one message works for every guest and every listing. Type a tag such as {guest_first_name} and each guest sees their own name.


Tags work in automated guest messages, saved replies, automated reviews, eSign rental agreements and the enquiry auto-responder. In a message rule, select a tag from the list above the message box to insert it.


Tags are filled in when the message sends, from the booking and listing as they are at that moment.


Where to see every tag


Open a listing from the Calendar, select Automated messages, then the Message tags tab. It lists every tag with an example in two groups:


  • Listing specific message tags: the same for every booking on the listing. You set the host names here; the rest come from the listing's details and address.
  • Booking specific message tags: filled in from each booking. They're shown so you know what to expect.


To see a message filled in for a real guest, use the preview on the rule. See Automated guest messages.



⚠️ Dates include the year


{check_in_date} and {check_out_date} include the year, for example 21st November 2026, wherever tags are used. There is no setting to leave it out.


⚠️ Check your wording. If you typed a year after the tag, guests see it twice: "on the {check_in_date} 2026" reads "on the 21st November 2026 2026". Remove the year you typed, and "the" if the sentence no longer reads well.


What each tag fills in


Guest

  • {guest_first_name} and {guest_surname}: the guest's name. If you set a preferred guest name on the booking, that's used instead. {guest_name} is the same as {guest_first_name}.
  • {guest_email}: the email address on the booking.
  • {guest_phone}: the phone number on the booking, blank if there isn't one. Many Booking.com and Airbnb bookings have none.
  • {guest_phone_last_4_digits}, {guest_phone_last_5_digits}, {guest_phone_last_6_digits}: the end of that number, often used as a door code. If there's no number, the last-4 tag uses Airbnb's suggested door code for the booking instead; the other two are blank.
  • {number_of_guests}: the number of guests on the booking.


Dates and times

  • {check_in_date} and {check_out_date}: the booking's dates, with the year.
  • {check_in_time} and {check_out_time}: the listing's standard times, in the form 3:00pm. They don't change when you change one guest's times.
  • {arrival_time} and {departure_time}: this booking's times. They match the listing's times unless you changed them on the booking, so use these when guests can arrive early or leave late.
  • {length_of_stay}: the number of nights.
  • {todays_date}: the date the message sends, in the listing's time zone. Useful as the signing date on a rental agreement.


Listing

  • {listing_name}: the listing's public name, not the nickname you see in Uplisting.
  • {listing_location}: the listing's town or city.
  • {listing_address}: the listing's full address.
  • {host_first_name} and {host_surname}: the names you set on the listing's Message tags tab.
  • {multi_unit_name}: the guest's unit on a multi-unit listing. Blank on other listings.
  • {wifi_name} and {wifi_password}: the unit's Wi-Fi if it has its own, otherwise the listing's.


Access and links

  • {lock_code}: the door code for this booking, blank if there isn't one. On a listing with an Uplisting smart lock, a message using it waits until the code is ready. See Automate guest access with Uplisting Smart Locks.
  • {guest_booking_link}: one link to the guest's booking page, with a summary of their stay and the steps you've switched on for their booking site, such as a security deposit or rental agreement.
  • {booking_site_name}: where the guest booked, for example Airbnb.
  • {direct_booking_website}: the address of your direct booking website.


Your own tags


When the tags above don't cover something, create your own. Both kinds are listed next to the message box once you've created them.


  • Custom property attribute tags, such as {{{parking_instructions}}}: one tag with a different value on each listing. Use them for lock-box codes, parking or floor numbers, so one rule serves every listing. See Custom property attribute tags.
  • Custom message tags, such as {{house_rules}}: the same text for all listings, which you can limit to some booking sites. For example, put your security deposit wording in a tag that only sends to Booking.com and direct guests, and Airbnb guests never see it. They can contain message tags. See Custom message tags.


Questions


I changed a guest's check-in time but the message shows the old one. Why?
{check_in_time} is the listing's standard time. Use {arrival_time}, which follows the booking.


A tag came out blank. Why?
That detail is missing from the booking or listing when the message sends, for example no Wi-Fi password on the listing. The preview on the rule flags these as "Empty for this booking".


A tag went out exactly as I typed it. Why?
It's misspelt or doesn't exist. Tags are lower case with underscores, inside one pair of curly brackets: {guest_first_name}. The preview flags these as "Not a recognised tag".



Updated on: 19/11/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!