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.

Table of contents:

Every Hostaway field is either reservation-level or listing-level, and that decides how you can map it:

Used 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.

Used 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.

Guest name, arrival and departure dates and contact details are imported automatically with each reservation. On top of these, the Hostaway data field picker offers the following fields:

Reservation-level (user/guest custom field)

Listing-level (guide custom field or topic customisation)

All listing-level fields are text unless marked as a link.

💡 Custom fields you create in Hostaway are also listed in the picker under their Hostaway names. Reservation custom fields are reservation-level and listing custom fields are listing-level. Hostaway number fields come through as Number; text, long text and dropdown fields come through as Text.

There are two ways to bring Hostaway listing 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 Hostaway listing. Reservation-level fields such as Door Code or Number of Guests work the same way, but through a user/guest custom field.

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:

👉 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 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 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.

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 Hostaway listing. Only listing-level fields can be mapped to a topic customisation.

Visibility Override Rules

These rules control whether a topic appears on a guide based on whether Hostaway 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 or Always Hide you set by hand for that topic on that guide is replaced.

Use this option if:

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. 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 Hostaway listing contains data for the mapped field, the topic's Visibility Rule will automatically be set to Always Show 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 Hostaway contains relevant information.

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.

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

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:

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 (legacy Hub only):

Go to Guides → open the guide → 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:

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.