> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.uplisting.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

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

![](https://storage.crisp.chat/users/helpdesk/website/-/1/b/e/b/1beb313cc044d100/04-1-message-tags-tab_1xrv4kk.png =800x1262)
To see a message filled in for a real guest, use the preview on the rule. See [Automated guest messages](https://support.uplisting.io/en/article/guest-message-rules-169wtsu/).


## ⚠️ 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](https://support.uplisting.io/en/article/automate-guest-access-with-uplisting-smart-locks-16g6006/).
- {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](https://support.uplisting.io/en/article/custom-property-attribute-tags-dz27bs/).
- **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](https://support.uplisting.io/en/article/custom-message-tags-78rd74/).

## 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".

## Related articles

- [Automated guest messages](https://support.uplisting.io/en/article/guest-message-rules-169wtsu/)
- [Custom message tags](https://support.uplisting.io/en/article/custom-message-tags-78rd74/)
- [Custom property attribute tags](https://support.uplisting.io/en/article/custom-property-attribute-tags-dz27bs/)
- [Saved replies](https://support.uplisting.io/en/article/saved-replies-zpvtgo/)
- [Automated reviews](https://support.uplisting.io/en/article/automated-reviews-10tqsh6/)
- [eSign rental agreements](https://support.uplisting.io/en/article/esign-rental-agreements-1mn28ug/)
- [Enquiry auto-responder](https://support.uplisting.io/en/article/enquiry-auto-responder-ejy2pe/)