Guide-level data mapping lets you automatically sync listing and reservation data from Guesty Pro 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 Guesty 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 Guesty data field picker offers the following fields:

Reservation-level (user/guest custom field)

Listing-level (guide custom field or topic customisation)

All of these are text fields:

💡 Custom fields you create in Guesty Pro are also listed in the picker under their Guesty names. Custom fields on the listing are listing-level; other Guesty custom fields are reservation-level.

There are two ways to bring Guesty 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 Guesty listing. Reservation-level fields such as Key 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 Guesty 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

Open any topic and click the Field Codes button. You'll see all available fields from the Guesty 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.

The same field codes work inside your 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 Guesty 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 Guesty 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:

Hide topic if content is blank

Choose this option if the mapped data isn't available for every property in Guesty. During the sync process, if a Guesty 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 Guesty 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 Guesty contains relevant information.

If you're syncing longer text fields, you can use simple HTML tags inside Guesty 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 Guesty 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 Guesty:

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

Mapped listing data (guide custom fields and topic customisations) is pulled in from Guesty Pro automatically once a day. New and updated reservations and guest details arrive separately, shortly after they change in Guesty.

If you've just changed listing data in Guesty and don't want to wait for the daily sync, 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 Guesty, but I can't see the changes in Touch Stay

Listing data is synced from Guesty to Touch Stay automatically once a day.

If you need the changes to appear sooner, trigger a manual sync — 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:

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.