HTML Letter Field Tags for Guest and Reservation Data (Cloud)
HTML letter field tags allow you to automatically insert guest, reservation, and property information into your HTML email templates. These tags act as placeholders that are replaced with real data—such as the guest’s name, arrival date, or confirmation number—when the email is sent. Field tags are added directly into your HTML file when creating or editing email templates outside of Visual Matrix.
Path: Management > Property Settings > Letters > HTML > Show Available Fields
Understanding Field Tags
How Field Tags Work
- Field tags are placeholders (e.g., @@fname@@) inserted into your HTML template.
- When the email is sent, these tags are replaced with actual guest and reservation data.
- Field tags can be used anywhere within your HTML structure (text, tables, etc.).
Where to Find Field Tags
- Click Show Available Fields in the Letters screen to view the full list.
- Copy and paste the tags directly into your HTML file.
Available Field Tags
Below is the complete list of available field tags.
Guest Information
- @@fname@@ – Guest first name
- @@lname@@ – Guest last name
- @@Address1@@ – Guest address line 1
- @@Address2@@ – Guest address line 2
- @@City@@ – Guest city
- @@State@@ – Guest state or province
- @@Zip_5Dig@@ – Guest ZIP/postal code (5-digit)
- @@Zip_4Dig@@ – Guest ZIP/postal code extension (last 4 digits)
- @@Country@@ – Guest country
- @@Telephone@@ – Guest phone number
- @@CCLast4Digits@@ – Last 4 digits of the credit card on file
- @@CompanyName@@ – Company associated with the reservation
- @@GuestProfile@@ – Guest profile identifier
- @@LoyaltyClubNum@@ – Guest loyalty or membership number
Rate Information
- @@FirstNightRate@@ – Rate for the first night of the stay
- @@AvgDailyRate@@ – Average daily room rate
- @@Extra1Descr@@ – Description of first extra charge
- @@Extra1Cost@@ – Amount of first extra charge
- @@Extra2Descr@@ – Description of second extra charge
- @@Extra2Cost@@ – Amount of second extra charge
- @@PkgDescr@@ – Package description applied to the reservation
- @@WeekDayDiscountCode@@ – Weekday discount code
- @@WeekDayDiscountDescr@@ – Description of weekday discount
- @@WeekEndDayDiscountCode@@ – Weekend discount code
- @@WeekEndDiscountDescr@@ – Description of weekend discount
- @@RateTypeDescr@@ – Description of the selected rate type
- @@AddOnPackageAmt@@ – Total amount for add-ons or package items
Property Information
- @@PropID@@ – Property ID
- @@PropName@@ – Property name
- @@PropAddr1@@ – Property address line 1
- @@PropAddr2@@ – Property address line 2
- @@PropCity@@ – Property city
- @@PropState@@ – Property state or province
- @@PropZip@@ – Property ZIP/postal code
- @@PropCountryName@@ – Property country name
- @@PropCountryCode@@ – Property country code
- @@PropTollFree@@ – Property toll-free phone number
- @@PropPhone@@ – Property phone number
- @@PropFax@@ – Property fax number
- @@PropEmail@@ – Property email address
- @@PropWebURL@@ – Property website URL
- @@PropTaxID@@ – Property tax identification number
Reservation Information
- @@crs_confirmation_number@@ – Reservation confirmation number
- @@check_in@@ – Arrival (check-in) date
- @@check_out@@ – Departure (check-out) date
- @@NumberOfNights@@ – Total number of nights
- @@cancellation_date@@ – Cancellation deadline or date
- @@RoomType@@ – Room type code
- @@RoomTypeDescr@@ – Room type description
- @@DepositAmount@@ – Deposit amount required or paid
- @@MethodOfPayment@@ – Payment method used for the reservation
- @@NumOfAdults@@ – Number of adults
- @@NumOfChildren@@ – Number of children
- @@ActivityText@@ – Additional activity or reservation notes
Group Information
- @@fname@@ – Group guest first name
- @@lname@@ – Group guest last name
- @@check_in@@ – Group arrival date
- @@check_out@@ – Group departure date
- @@EventName@@ – Group or event name
- @@CRSGroupID@@ – Group reservation ID
- @@GroupURL@@ – Group booking or information link
Example of Field Tag Usage
Below is a simple example of how field tags can be used in an HTML letter:
Still Need Help With This Topic?
Ask Yourself:
- Did you use the correct field tag format (e.g., @@field@@)?
- Are the tags placed correctly in your HTML file?
- Did you upload the updated HTML file after making changes?
Support May Ask You:
- Which field tag are you trying to use?
- Where is the tag placed in your HTML file?
- Is the issue happening in preview or in the sent email?
Related Articles
Related Articles
Configuring Custom Letters for Guest Communications (Cloud) 🎥
? Watch Video Custom letters allow your property to customize the message included with reservation confirmations. They function as a standard confirmation letter with a modified body text, while all reservation details remain unchanged. Custom ...Configuring Confirmation Letters for Guest Reservations (Cloud) 🎥
? Watch Video Confirmation letters provide guests with a summary of their reservation details and serve as an official record of their booking. In Visual Matrix Cloud, these letters can be automatically sent when a reservation is created or manually ...Uploading HTML Letters for Guest Emails (Cloud)
Uploading an HTML letter allows your property to customize the appearance of confirmation, promotional, or custom emails sent to guests. Instead of using the standard PDF attachment, HTML letters display directly in the email body, giving you more ...Configuring Promotional Letters for Guest Marketing Emails (Cloud) 🎥
? Watch Video Promotional letters are used to send marketing or informational messages to groups of guests. These letters are typically sent in bulk through the Promotional Letter feature and are delivered as an attachment to the email. They are ...**Reservation Form Fields Explained (Cloud) 🎥
? Watch Video The Add Res form is the most complete way to create and manage an individual reservation in VM Cloud. While BookRes is designed for speed, capturing only the essential information (guest name, rate, room type, etc.) to create a ...