HTML Letter Field Tags for Guest and Reservation Data (Cloud)

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
  1. Field tags are placeholders (e.g., @@fname@@) inserted into your HTML template.
  2. When the email is sent, these tags are replaced with actual guest and reservation data.
  3. Field tags can be used anywhere within your HTML structure (text, tables, etc.).
Where to Find Field Tags
  1. Click Show Available Fields in the Letters screen to view the full list.
  2. Copy and paste the tags directly into your HTML file.


Available Field Tags

Below is the complete list of available field tags.
Guest Information
  1. @@fname@@ – Guest first name
  2. @@lname@@ – Guest last name
  3. @@Address1@@ – Guest address line 1
  4. @@Address2@@ – Guest address line 2
  5. @@City@@ – Guest city
  6. @@State@@ – Guest state or province
  7. @@Zip_5Dig@@ – Guest ZIP/postal code (5-digit)
  8. @@Zip_4Dig@@ – Guest ZIP/postal code extension (last 4 digits)
  9. @@Country@@ – Guest country
  10. @@Telephone@@ – Guest phone number
  11. @@CCLast4Digits@@ – Last 4 digits of the credit card on file
  12. @@CompanyName@@ – Company associated with the reservation
  13. @@GuestProfile@@ – Guest profile identifier
  14. @@LoyaltyClubNum@@ – Guest loyalty or membership number
Rate Information
  1. @@FirstNightRate@@ – Rate for the first night of the stay
  2. @@AvgDailyRate@@ – Average daily room rate
  3. @@Extra1Descr@@ – Description of first extra charge
  4. @@Extra1Cost@@ – Amount of first extra charge
  5. @@Extra2Descr@@ – Description of second extra charge
  6. @@Extra2Cost@@ – Amount of second extra charge
  7. @@PkgDescr@@ – Package description applied to the reservation
  8. @@WeekDayDiscountCode@@ – Weekday discount code
  9. @@WeekDayDiscountDescr@@ – Description of weekday discount
  10. @@WeekEndDayDiscountCode@@ – Weekend discount code
  11. @@WeekEndDiscountDescr@@ – Description of weekend discount
  12. @@RateTypeDescr@@ – Description of the selected rate type
  13. @@AddOnPackageAmt@@ – Total amount for add-ons or package items
Property Information
  1. @@PropID@@ – Property ID
  2. @@PropName@@ – Property name
  3. @@PropAddr1@@ – Property address line 1
  4. @@PropAddr2@@ – Property address line 2
  5. @@PropCity@@ – Property city
  6. @@PropState@@ – Property state or province
  7. @@PropZip@@ – Property ZIP/postal code
  8. @@PropCountryName@@ – Property country name
  9. @@PropCountryCode@@ – Property country code
  10. @@PropTollFree@@ – Property toll-free phone number
  11. @@PropPhone@@ – Property phone number
  12. @@PropFax@@ – Property fax number
  13. @@PropEmail@@ – Property email address
  14. @@PropWebURL@@ – Property website URL
  15. @@PropTaxID@@ – Property tax identification number
Reservation Information
  1. @@crs_confirmation_number@@ – Reservation confirmation number
  2. @@check_in@@ – Arrival (check-in) date
  3. @@check_out@@ – Departure (check-out) date
  4. @@NumberOfNights@@ – Total number of nights
  5. @@cancellation_date@@ – Cancellation deadline or date
  6. @@RoomType@@ – Room type code
  7. @@RoomTypeDescr@@ – Room type description
  8. @@DepositAmount@@ – Deposit amount required or paid
  9. @@MethodOfPayment@@ – Payment method used for the reservation
  10. @@NumOfAdults@@ – Number of adults
  11. @@NumOfChildren@@ – Number of children
  12. @@ActivityText@@ – Additional activity or reservation notes
Group Information
  1. @@fname@@ – Group guest first name
  2. @@lname@@ – Group guest last name
  3. @@check_in@@ – Group arrival date
  4. @@check_out@@ – Group departure date
  5. @@EventName@@ – Group or event name
  6. @@CRSGroupID@@ – Group reservation ID
  7. @@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:
  1. Did you use the correct field tag format (e.g., @@field@@)?
  2. Are the tags placed correctly in your HTML file?
  3. Did you upload the updated HTML file after making changes?
Support May Ask You:
  1. Which field tag are you trying to use?
  2. Where is the tag placed in your HTML file?
  3. Is the issue happening in preview or in the sent email?
  1. Uploading HTML Letters for Guest Emails (Cloud)
  2. Configuring Confirmation Letters for Guest Reservations (Cloud)
  3. Configuring Custom Letters for Guest Communications (Cloud)
  4. Configuring Promotional Letters for Guest Marketing Emails (Cloud)
  5. FAQ - Management / Letters (PMS)