Skip to main content

Field Codes Explained (New Hub)

Field Codes are smart placeholders that automatically fill in with the right information for each guide, guest or message. They let you personalise your guidebook content and messages without manually editing anything for each guest.

In the new Hub, Field Codes live in the Account library → Field Codes section — one central place where all your dynamic codes are managed and available across every guidebook and message.


How Field Codes work

You add a short code like ###{{guest_first_name}} into your guide content or message template. When your guest views the guide or receives a message, Touch Stay replaces the code with the real information automatically.

Example:

You write:

"Hi ###{{guest_first_name}}, we can't wait to welcome you to ###{{guide_name}} on ###{{arrival_date}}!"

Your guest sees:

"Hi Sarah, we can't wait to welcome you to Casa del Sol on 10 July!"


Where to find Field Codes

  1. Open the Account library from the left sidebar.

  2. Click Field Codes.

Here you can see all your standard and custom Field Codes, create new ones, and set substitute values.


Using Field Codes in guide content

You can use Field Codes directly inside your guidebook topics to make content feel unique for each property or guest.

Example: ###{{guide_name}} can turn a category title like "About the Accommodation" into "About Casa del Sol" — automatically, for each guidebook.

How to insert a Field Code in your guide:

  • For section titles — click the Insert Field Code button

  • For topic content — use the Field Code option in the text editor toolbar

⚠️ Note about Quick Share links: If you share your guide using a Quick Share link (instead of a personalised invitation), some Field Codes won't have data to display — the Quick Share link is the same for all viewers and isn't tied to an invitation. In those cases, the substitute value will be shown instead (see the Substitute Values section below).


Using Field Codes in message templates

Field Codes make your automated messages personal without extra work. For example, ###{{guest_first_name}} will automatically be replaced by the guest's actual first name when the message is sent.

How to insert a Field Code in messages:

  • For the email from name or subject line — click Insert Field Code

  • For email body or SMS content — use the Field Code option in the text editor toolbar

💡 Tip: You can also use Field Codes when setting message template criteria, helping determine which messages apply to which guide or guest. Learn more: [Message template criteria explained]


Standard Field Codes

These come with your account automatically and are based on fixed fields in Touch Stay:

Guide-related codes:

Code

What it inserts

guide_name

The name of the guide

guide_address ¹

The street address of the guide

guide_city

The city of the guide

guide_region_state

The region or state of the guide

guide_zipcode

The zip/post code of the guide

guide_country

The country of the guide

guide_contact_name

The contact name set on the guide or in account profile

guide_contact_email

The contact email set on the guide or in account profile

guide_contact_phone

A clickable phone link to the contact phone number

guide_contact_sms

A clickable SMS link to the contact phone number

Guest-related codes:

Code

What it inserts

guest_first_name

The guest's first name (from the invitation)

guest_last_name

The guest's last name (from the invitation)

guest_email

The guest's email address (from the invitation)

guest_phone

The guest's phone number (from the invitation)

arrival_date

The arrival/start date (from the invitation)

departure_date

The departure/end date (from the invitation)

Other codes:

Code

What it inserts

host_name

The first name set in your account profile

invitation_link ¹

The unique link for the invitation

invitation_view_count ¹

The number of views the invitation has had

tag ²

Any active tags on the guide

Notes:

  • ¹ These codes are not available when setting message criteria.

  • ² This code is not available in message templates or guide content.


Custom Field Codes

You can create your own Field Codes for anything that's useful for personalising information for your guests — lock codes, review links, booking IDs, and more.

How to create a custom Field Code:

  1. Open Account library → Field Codes.

  2. Click Create new Field Code.

  3. Configure the following:

Field Code Name

The name also forms the short code used in your content. Rules:

  • Letters, numbers, underscores and hyphens only

  • No spaces or special characters

  • The double curly brackets are added automatically — you don't need to add them yourself

Field Type

Determines where the data is set:

Field Type

When to use

Example

User/Guest

Data set when creating an invitation — specific to each guest

Lock code, parking space number

Guide

Data set on the guidebook — specific to each property

Review link, property manager name

Data Type

Determines what kind of data the Field Code holds:

Data Type

What it accepts

Example use

Text

Free plain text

Reservation or booking ID

List

A predefined set of values (enter each separated by a comma)

Guest type (couple, family, celebration)

Link

A web link — renders as a clickable link when displayed

Your website reviews page

Date

A fixed date — enables time-related criteria (before, after)

Event date, seasonal changeover

Number

Whole numbers only — enables value-related criteria (greater than, less than)

Number of guests, floor number

Yes or No

A simple yes/no choice

Airport transfer booked, welcome hamper requested

💡 Note: Custom fields allow up to 65,000 characters, but the content can't be formatted — no line breaks or paragraphs.

Substitute Value

An optional fallback shown when the Field Code data is missing.

Example: You create a custom Field Code called ###{{lock_code}}. You set the substitute value to "Call us if code is missing". If you ever forget to add the lock code to an invitation, the substitute value appears instead — so your guest is never left without instructions.

Substitute values are also used for standard Field Codes on your Quick Share link, where invitation-specific data isn't available.


What's different from the legacy Hub?

Legacy Hub

New Hub

Field Codes managed from the Field Codes tab on the Account page

Field Codes managed from Account library → Field Codes

Accessed separately from other reusable content tools

Grouped with Tags, Custom Elements and Content Hub in the Account library

Same functionality

Same functionality — the features haven't changed, just the location

Did this answer your question?