Facebook Tracking Pixel

Importing Guides from TouchStay

February 1, 2026 719 views Barry Murphy
Import your TouchStay guide into BetterSTR: pages, text, icons and photos, plus the places on your TouchStay map.

If you are switching from TouchStay to BetterSTR, you can import your existing guides rather than recreating them from scratch. The import tool transfers your content structure, text, icons and photos automatically, and can add the places from your TouchStay map to your BetterSTR map.

Prefer to watch? This 3-minute video walks through the import, start to finish.

Import TouchStay Guide into BetterSTR

 

Before You Begin

You will need:

  • Your TouchStay guide URL (the public guest link)
  • A BetterSTR property that doesn’t have a guide yet to import into

 

Finding Your TouchStay URL

Your TouchStay guide URL looks like:

https://guide.touchstay.com/guest/bu9DPEMCs0sGq

You can find this by:

  1. Opening your TouchStay guide
  2. Copying the URL from your browser address bar

 

Starting the Import

The importer is offered wherever you create a guide for a property that doesn’t have one yet.

From the property page

  1. Go to Properties and open the property you want to import into
  2. In the Actions card, click Create Guide. The Guide Builder opens in a new window
  3. The Create or Copy a Guide window opens by itself. Click Copy a TouchStay Guide

Property page Actions card with Create Guide highlighted

Guide Builder's Create or Copy a Guide window with Copy a TouchStay Guide highlighted

From the Live Editor

If you open the Live Editor for a property with no guide, you’ll see a No guide for this property yet banner. Click Create a guide for this property, then Import from TouchStay. The importer opens in a new tab, and when you come back and close the Create or Copy a Guide window, the guide page reloads to show your imported guide.

Live Editor's Create or Copy a Guide window with Import from TouchStay highlighted

For your Default Guide

When you set up your Default Guide for the first time, the setup screen has an Import from TouchStay option. The TouchStay content becomes your Default Guide, and you’re taken back to it to edit inline when the import finishes. The map places step below isn’t offered for the Default Guide, because it isn’t tied to one property’s map.

 

Import Process

TouchStay Guide Importer form with the guide URL field, the destination guide and the Import Guide button, numbered 1 to 3

Step 1: Enter Your TouchStay URL (1)

  1. Paste your TouchStay guide URL into the TouchStay Guide URL field
  2. The link is checked as you type
  3. You will see Valid TouchStay URL in green when the link is in the right format

Step 2: Check the Destination (2)

The Destination Guide is the property you started from, so it’s already filled in. If you open the importer without a property, choose the destination guide from the list instead.

Step 3: Import (3)

  1. Click Import Guide
  2. Wait while the system fetches and processes your content. This can take up to 30 seconds, so don’t close the page
  3. When it finishes you will see Your guide is imported. All your pages and text are now in your BetterSTR guide.

If TouchStay blocks the automatic fetch, the importer shows an Import via your browser instead card with a link to open your guide data in a new tab. Select everything on that page, copy it, paste it into the box and click Import Pasted Data. The rest of the import works the same way.

After the import, two optional steps follow. Your guide is already fully imported at this point, so if either one doesn’t work, your guide stays as it is.

Import finished screen with Add map places, Copy photos and Continue to your guide, numbered 1 to 3

Step 4: Add Your Map Places (optional) (1)

If your TouchStay guide has places on its map (restaurants, activities, beaches and so on), the importer tells you how many it found. Click Add map places to add them to this property’s map, with each place’s name, location, description and an icon matching its TouchStay category. Places already on your map are skipped, so running it twice won’t create duplicates. You can also click Skip and add places later on the Map page.

Step 5: Copy Your Photos (optional) (2)

Your imported pages show the same photos as your TouchStay guide, but those photos are still stored on TouchStay and will stop working once you leave. Click Copy photos to copy them into your BetterSTR Media library; your guide is updated to use the copies automatically. Keep the page open while it runs, which usually takes a minute or two. If there are map places to add, Copy photos becomes available once you’ve added or skipped them.

If a photo can’t be copied, the importer tells you how many and gives you a Try again button. Any photo that still won’t copy keeps showing from TouchStay for now, so replace it in the guide editor before you close your TouchStay account.

Click Continue to your guide (3) at any time to go to the Guide Builder. Your guide is already fully imported, so skipping either step loses nothing.

 

What Gets Imported

Imported Content

  • Categories - Top-level menu items
  • Subcategories - Second-level menu items
  • Topics - Individual content pages
  • Text Content - All descriptions and text (HTML preserved)
  • Icons - Automatically mapped to FontAwesome equivalents
  • Structure - Full hierarchy and display order
  • Photos - Each topic’s main photo (placed at the top of its page) and photos inside your text, copied into your Media library in Step 5
  • Map places - Added to the property’s map in Step 4

Icon Mapping

Each top-level TouchStay category’s icon is converted, and its subcategories and topics use the same icon. You can change any icon in the editor afterwards.

TouchStay Icon BetterSTR Icon
Hand fa-hand
Numbers fa-list-ol
Key fa-key
Wifi fa-wifi
House fa-house
Book-Open fa-book-open
Phone fa-phone
Suitcase fa-suitcase
Star fa-star
Washing-Machine fa-washing-machine

Unmapped icons default to an info circle.

 

What Is NOT Imported

Important: The following items must be added manually after import:
  • Other languages - Only the English version of your guide is imported. Sections with no English title are skipped. Add your other languages in BetterSTR after the import
  • Google photos of places - Photos TouchStay pulled in from Google for a place aren’t copied. Add your own photo if you want one
  • Videos - Re-embed video content
  • Dynamic Widgets - Weather, ratings, etc.
  • Master Content - Shared content blocks

 

After Import

Once your guide is imported:

  1. Review the structure - Check that all sections imported correctly
  2. Check your photos - Replace any the importer couldn’t copy, and add any extras you want
  3. Update property-specific content - WiFi, codes, addresses
  4. Add shortcodes - Replace static text with dynamic shortcodes
  5. Preview your guide - View as your guests will see it

 

Troubleshooting

Invalid URL Error

Ensure your URL matches the format: https://guide.touchstay.com/guest/XXXXX. Custom domains such as https://your-place.touchstay.com/guest/XXXXX work too, as long as the link contains /guest/.

Import Failed

Possible causes:

  • The TouchStay guide is not publicly accessible, or is protected with a PIN
  • The guide has been deleted or moved
  • Temporary API issues

If the importer offers Import via your browser instead, follow those two steps to paste your guide data in. Otherwise try again in a few minutes. If the problem persists, contact support.

Missing Content

If some content did not import:

  • Check if it was in a special content type (video, widget) or only in a language other than English
  • Manually add the missing sections

 

Tips for a Smooth Migration

Plan Your Import

Review your TouchStay guide before importing to know what manual updates will be needed.

One Property at a Time

Import each property guide separately, into a property that doesn’t have a guide yet. The importer adds pages rather than replacing them, so importing into a guide that already has content puts the TouchStay pages alongside what’s there.

Update Shortcodes

After import, replace static content with BetterSTR shortcodes for dynamic information like WiFi passwords and check-in times.