Guide-level data mapping lets you automatically sync listing and reservation data from Hostaway into your Touch Stay guides. This article covers everything you need to set it up, from understanding the two mapping types to adding fields to using your data inside guide content.
Understanding Data Sources in Hostaway
When creating a new mapping, you'll be asked to choose a mapping type. The right choice depends on whether the information changes per reservation or stays the same per property.
User/Guest Custom Field
Use this for information that changes with every reservation, such as:
Reservation number
Door code (if it's different for each booking)
Hostaway guest portal
This data is linked to the reservation and only appears when a guest opens their personalised invitation link.
Guide Custom Field
Use this for information that belongs to the property and stays the same across all reservations, such as:
Wi-Fi details
Parking information
House rules
Cleaning instructions
This data is linked to the property listing and displays in the guide itself.
Additional fields you can map
On top of the fields that are automatically mapped at setup, Hostaway provides several additional fields you can manually map for more advanced personalisation:
Field | Mapping type | Data Type |
Door code | User/guest custom field | Text |
Hostaway Email | User/guest custom field | Text - when added as the reply-to email in your Message Hub templates, any replies will go to your Hostaway inbox |
Channel Reservation ID | User/guest custom field | Number |
Hostaway Reservation ID | User/guest custom field | Number |
WIFI Username | Guide custom field | Text |
WIFI Password | Guide custom field | Text |
💡 You can also create your own custom fields directly in Hostaway and map those to Touch Stay too, giving you full flexibility over what data appears in your guides.
Choose how you'd like to display your data
There are two ways to bring Hostaway data into your guides, depending on how much content you're syncing and where you want it to appear.
Option 1. Guide Custom Fields
Best for short pieces of information you want to drop into an existing topic, such as:
Wi-Fi username
Wi-Fi password
Parking space number
Door code
Number of guests per reservation
Once mapped, you insert the field into your topic content using a field code. Each guide will automatically display the correct information from its Hostaway listing.
How to create a mapping with a Custom Field
Go to Integrations
Click Map Data.
Click + Add new mapping
Select the Hostaway data field you'd like to sync
Choose an existing custom field, or click + New Custom Field to create one. If creating a new custom field:
Enter a Field Code. We recommend adding
_hostawayto the end (e.g.door_code_hostaway) so it's easy to identify where the data is coming fromOptional - Add a Substitute Value (see below) to display when data is missing.
Click Save.
Substitute Value
A substitute value is a fallback for when Hostaway doesn't provide data for a particular reservation or property. Instead of showing a blank field, Touch Stay will display your substitute instead. For example
Contact us if this information is missing
Not provided
Please ask your host
👉 Learn more: Field Codes Explained.
Using Your Custom Fields Mapped Data
Once a field has been mapped, you can use it throughout Touch Stay, including:
Topic content
Under your Content Hub, open any topic and click the Field Codes button. You'll see all available fields from the Hostaway integration, guest details, arrival and departure dates, check-in and check-out times, and any additional fields you've mapped.
Insert them directly into your content to personalise each guest's experience automatically.
In Message Hub Touch Stay templates
The same field codes work inside your Message Hub message templates, so you can send personalised guest communications without any manual updates per reservation.
Option 2. Topic Customisations
Best for longer content that deserves its own topic in the guide, such as:
Parking instructions
How to access the property
Appliance instructions
House rules
Cleaning instructions
Property-specific amenities
Touch Stay creates a customised version of the selected topic for each guide, using the content stored in the corresponding Hostaway listing.
⚠️ Heads up: You'll need to create the topic in your Content Hub before it can be selected here. We recommend building your master topic first, then coming back to map the Hostaway data to it.
How to create a mapping with Topic Customisations
Go to Integrations.
Open the Map Data tab.
Click + Add New Mapping.
Select the Hostaway data field you'd like to sync.
Under Mapping Type, select Topic Customisation.
Choose the Touch Stay topic you'd like to populate; you can search by name
Choose a Visibility Override Rule (see below)
Click Save
Visibility Override Rules
These rules control whether a topic appears on a guide based on whether Hostaway listings have data for it.
There are three visibility options to choose from, depending on whether the data is available for every property and how you've set up your tags.
None
This is the simplest option.
The sync process won't make any changes to the topic's visibility. The topic will continue to appear based on its active tags.
Use this option if:
The data is always present in Hostaway, or
You have a generic version of the content for that topic added to Content Hub which you would like to show in the absence of listing-specific content in Hostaway.
Hide topic if content is blank
Choose this option if the mapped data isn't available for every property in Hostaway
During the sync process, if a Hostaway listing doesn't contain any data for the mapped field, the topic's Visibility Rule will automatically be set to Always Hide, so it won't appear on that guide.
Show topic if content is not blank
This option works in the opposite way.
If a Hostaway listing contains data for the mapped field, the topic's Visibility Rule will automatically be set to Always Show for that guide.
This works well for optional topics that don't have a tag assigned in the Content Hub, allowing the topic to appear only on guides where Hostaway contains relevant information.
Formatting synced content from Hostaway
If you're syncing longer text fields, you can use simple HTML tags inside Hostaway to control how the content displays in Touch Stay. This applies to both Guide Custom Fields and Topic Customisations.
Without any formatting, long text can arrive as one unbroken block. Adding a couple of HTML tags in Hostaway fixes this.
Example - unformatted:
There is one free parking space available for guests in spot 24. Please make sure the parking permit is always displayed on the dashboard of your car. Additional street parking is available on Oak Street after 6pm.
Example - formatted in Hostaway:
Parking Information<br><br>There is one free parking space available for guests in spot 24.<br><br>Please make sure the parking permit is always displayed on the dashboard of your car.<br><br>Additional street parking is available on Oak Street after 6pm.
When it syncs to Touch Stay, the content will display with proper spacing and be much easier for guests to read.
Common HTML tags
HTML tag | Result |
| Starts a new line |
| Adds a blank line between paragraphs |
💡 If you need help editing custom fields or adding HTML formatting in Hostaway, reach out to Hostaway Support. These fields are managed within your Hostaway account
Syncing the guide data
Listing data syncs automatically between Hostaway and Touch Stay every 24 hours. If you've just made a change and don't want to wait, you can trigger a manual sync any time.
Resync all guides
Go to Integrations.
Open the Map Data tab.
Click Resync Guide Data (located below the Hostaway logo).
This will sync all mapped data for every guide.
💡 Good to know
If you have a large number of guides or mapped fields, the sync may take a few minutes to complete.
Resync a single guide
Go to the Guides page.
Open the guide you'd like to update.
Open the Guide Details tab.
In the Hostaway Integration section, click Edit.
Click Resync guide data.
FAQs
I updated a property custom field in Hostaway, but I can't see the changes in Touch Stay
Property data is automatically synced from Hostaway to Touch Stay every 24 hours.
If you need the changes to appear sooner, you can manually trigger a sync:
To update all guides
Go to Integrations → Map Data and click Resync Guide Data.
To update a single guide:
Go to Guides → Guide Details → Hostaway Integration, click Edit, then select Resync guide data.
💬 Still not seeing the updated data?
If you've completed the steps above and the changes still aren't appearing in Touch Stay, please contact [email protected] and include:
Your login email address
Guide name
The custom field name
When the field was updated in Hostaway
A screenshot of the value in Hostaway (if possible)
🤝 Need Help?
If you have any questions or need help setting things up, just get in touch.
Or send us a support ticket directly from your Touch Stay account.











