Guide-level data mapping lets you automatically sync listing and reservation data from Homhero 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.
Table of contents:
Understanding Data Sources in Homhero
Every Homhero field is either reservation-level or guide-level, and that decides how you can map it:
Reservation-level fields map straight to a user/guest custom field. You won't see a mapping type step for these.
Guide-level fields show a Choose mapping type step, where you pick Guide custom field or Topic customisation.
User/Guest Custom Field
Used for information that changes with every reservation, such as:
Access code (if it's different for each booking)
Number of adults
Arrival notes
This data is linked to the reservation and only appears when a guest opens their personalised invitation link.
Guide Custom Field
Used for information that belongs to the property and stays the same across all reservations, such as:
Key number
Check-in notes
Custom fields on your Homhero rentals (for example, Wi-Fi details)
This data is linked to the property listing and displays in the guide itself.
Fields you can map
Guest name, arrival and departure dates and contact details are imported automatically with each reservation. On top of these, the Homhero data field picker offers the following fields:
Field | Level | Data type |
Adults, Children, Infants, Pets | Reservation | Number |
Nights | Reservation | Number |
Reservation Note, Arrival Notes, Departure Notes | Reservation | Text |
Lockbox Code, Access Code | Reservation | Text |
Bedding Config, Portacot, Agent, Review | Reservation | Text |
Description, Check-In Notes, Key Number | Guide | Text |
Listing Notes, Cleaner Notes, Checklist, Lease Agreement | Guide | Text |
💡 Your own Homhero fields are listed too:
Custom fields on your Homhero rentals and areas appear as guide-level fields.
Extra booking fields found on your upcoming reservations (Touch Stay checks up to 50) appear as reservation-level text fields.
Choose how you'd like to display your data
There are two ways to bring Homhero guide-level 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:
Key number
A Wi-Fi name or password stored in a Homhero custom field
Once mapped, you insert the field into your topic content using a field code. Each guide will automatically display the correct information from its Homhero listing. Reservation-level fields such as Access Code or Adults work the same way, but through a user/guest custom field.
How to create a mapping with a Custom Field
Go to Integrations.
Open the Map data tab.
Click Add new mapping.
Select the Homhero data field you'd like to sync.
For a guide-level field, select Guide custom field under Choose mapping type. (Reservation-level fields skip this step.)
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
_homheroto the end (e.g.key_number_homhero) so it's easy to identify where the data is coming from.Optional - Add a Substitute Value (see below) to display when data is missing.
Click Save.
For guide-level fields, click Resync guide data to pull the latest information from Homhero and populate the mapped field in your guides. Reservation-level fields are filled in as reservations sync.
Note: You only need to click Resync guide data when you create a new guide-level mapping or when you've updated the value of a mapped field in Homhero and want those changes to be reflected in Touch Stay immediately.
Substitute Value
A substitute value is a fallback for when Homhero 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 Homhero 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 templates
The same field codes work inside your Message Hub message templates so that 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:
Check-in notes
Property description
Listing notes
Longer custom fields on your Homhero rentals, such as appliance instructions
Touch Stay creates a customised version of the selected topic for each guide, using the content stored in the corresponding Homhero listing. Only guide-level fields can be mapped to a topic customisation.
⚠️ 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 Homhero 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 guide-level Homhero data field you'd like to sync.
Under Choose 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.
Click Resync guide data to pull the latest information from Homhero.
Visibility Override Rules
These rules control whether a topic appears on a guide based on whether Homhero listings have data for it. The rule is applied to each guide every time the listing data syncs.
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
Each time the data syncs, the topic's visibility on that guide is set back to normal, so it appears based on its active tags. Any Always show topic or Never show topic you set by hand for that topic on that guide is replaced.
Use this option if:
The data is always present in Homhero, 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 Homhero.
Hide topic if content is blank
Choose this option if the mapped data isn't available for every property in Homhero. During the sync process, if a Homhero listing doesn't contain any data for the mapped field, the topic's Visibility Rule will automatically be set to Never show topic, so it won't appear on that guide. Otherwise, the topic's visibility on that guide is set back to normal.
Show topic if content is not blank
This option works in the opposite way. If a Homhero listing contains data for the mapped field, the topic's Visibility Rule will automatically be set to Always show topic for that guide. Otherwise, the topic's visibility on that guide is set back to normal.
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 Homhero contains relevant information.
Formatting synced content from Homhero
If you're syncing longer text fields, you can use simple HTML tags inside Homhero 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 Homhero 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 6 pm.
Example - formatted in Homhero:
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 6 pm.
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 Homhero, reach out to Homhero Support. These fields are managed within your Homhero account.
Syncing the guide data
Listing data syncs automatically between Homhero 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 Homhero 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 (legacy Hub only)
The new Hub doesn't have a single-guide resync — use Resync guide data on the Map data tab above, which updates every guide. On the legacy Hub you can resync one guide:
Go to the Guides page.
Open the guide you'd like to update.
Open the Guide Details tab.
In the Homhero Integration section, click Edit.
Click Resync guide data.
FAQs
I updated a property custom field in Homhero, but I can't see the changes in Touch Stay
Property data is automatically synced from Homhero to Touch Stay every 24 hours.
If you need the changes to appear sooner, you can manually trigger a sync from the Map data tab (or, on the legacy Hub, from the guide itself).
👉 For full steps, see Syncing the 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 Homhero
A screenshot of the value in Homhero (if possible)
My Homhero custom field isn't in the Map data list
When you open the Map data tab, Touch Stay loads your Homhero fields in the background. The list shows as loading until it's ready, which can take a little longer if you have a lot of properties. If you see Failed to load field mappings from your PMS, reload the page and try again.
Your own fields come from two places:
Guide-level fields: Touch Stay checks every property in your Homhero account and lists the custom fields it finds. A field appears if at least one property has it.
Reservation-level fields: Touch Stay checks the first 50 reservations Homhero returns that haven't ended yet (departing today or later). A booking field appears if it's on at least one of them.
Touch Stay remembers the list of property fields for up to 15 minutes, so a custom field you've just added in Homhero can take that long to show up.
🤝 Need help?
Our Fin AI assistant is available 24/7 and typically responds in under 10 seconds. If Fin isn't able to solve your issue, our support team will take ownership of your case from there.
You can also reach out to our team at [email protected], and we'll be happy to help.