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.

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.

Use this for information that changes with every reservation, such as:

This data is linked to the reservation and only appears when a guest opens their personalised invitation link.

Use this for information that belongs to the property and stays the same across all reservations, such as:

This data is linked to the property listing and displays in the guide itself.

On top of the fields that are automatically mapped at setup, Homhero provides several additional fields you can manually map for more advanced personalisation:

💡 You can also create your own custom fields directly in Homhero and map those to Touch Stay too, giving you full flexibility over what data appears in your guides.

There are two ways to bring Homhero data into your guides, depending on how much content you're syncing and where you want it to appear.

Best for short pieces of information you want to drop into an existing topic, such as:

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.

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:

👉 Learn more: Field Codes Explained.

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 Touch Stay 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.

Best for longer content that deserves its own topic in the guide, such as:

Touch Stay creates a customised version of the selected topic for each guide, using the content stored in the corresponding Homhero listing.

Visibility Override Rules

These rules control whether a topic appears on a guide based on whether Homhero 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:

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 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 Homhero 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 Homhero contains relevant information.

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

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

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 either the integration page or the guide level.

👉 For full steps, see Syncing your 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:

If you have any questions or need help setting things up, just get in touch.

[email protected]

Or send us a support ticket directly from your Touch Stay account.