Skip to main content

How to embed AllTrails in your guide

Drop an AllTrails map into any section of your Touch Stay guidebook to make it fun for guests to explore the area around your property, build excitement and plan, long before they arrive.

Table of contents:

Video: How to add an AllTrails walking tour to your Touch Stay guidebook

How to add an AllTrails walking tour to your Touch Stay guidebook

Step 1: Get the embed code from AllTrails

  1. Open the route in AllTrails, then click Share.

  2. Select Embed.

  3. Copy the iframe code. It will look something like this:

<iframe class="alltrails" src="https://www.alltrails.com/widget/trail/costa-rica/puntarenas--2/playa-biesanz-playa-tulemar" width="100%" height="400" frameborder="0" scrolling="no" marginheight="0" marginwidth="0" title="AllTrails: Trail Guides and Maps for Hiking, Camping, and Running"></iframe>

Step 2: Create a Custom Element in Touch Stay

  1. Open Custom Elements:

    • New Hub: Account library → Custom Elements in the left sidebar (multi-account owners: Content Hub → Custom Elements)

    • Legacy Hub: Settings → Custom Elements

  2. Click New Custom Element.

  3. Complete the following fields:

    • Third Party Service: AllTrails

    • Element code name: Give the element a short, descriptive name so it's easy to recognise later (for example, ManuelAntonioTrail or WaterfallWalk). Only letters, numbers, underscores (_), and hyphens (-) are allowed, no spaces or special characters.

    • AllTrails embed code: Paste the iframe code you copied from AllTrails.

  4. Click Save.

Step 3: Add the route to your guidebook

  1. Open the topic where you want to display the route (new Hub: open the guidebook and go to the Guidebook Content tab; legacy Hub: Content Hub).

  2. Click Custom Element in the editor toolbar.

  3. Select the AllTrails element you created and click Insert.

  4. Save the topic (new Hub: Save Changes; legacy Hub: Save).

This will place your custom element code into your topic content, and when you preview the guide, it will be replaced by your chosen AllTrails map.

Troubleshooting - FAQs

My embed code isn't being accepted when creating my custom element, what should I do?

If your embed code isn't being accepted, then the most likely reason is that it's the wrong embed code. Touch Stay needs the full iframe code from AllTrails' Share → Embed option, pointing to https://www.alltrails.com/. If this still doesn't work, or you can't find it in your AllTrails account, then please contact support and send us a screenshot of the AllTrails share options that are available to you.

My AllTrails map doesn't display fully or has lots of space beneath it, what should I do?

The AllTrails route is added to your guide using an iframe. Depending on the size of the route, you may want to adjust its height so it displays better in your guide. To do this:

  1. Open Custom Elements (new Hub: Account library → Custom Elements; legacy Hub: Settings → Custom Elements).

  2. Click the ⋮ (three dots) next to your AllTrails custom element and select View/Edit.

  3. Adjust the Standard element height as needed and click Save.

Tip: Keep your guide preview open in another tab. Refresh it after each height adjustment until the route displays as you'd like.

Can I have a different version of the AllTrails map for each of my guides?

On the legacy Hub, you can override the default custom element at the guide level. This is useful if each property has its own trail.

  1. Go to Guides and open the guide you want to update.

  2. Scroll to the bottom of the Guide Details page.

  3. On the Guide Custom Elements card, click Edit.

  4. In the Edit Custom Elements (this guide only) window, paste the embed code for this guide.

  5. Adjust the height if needed, then click Save.

Notes:

  • This only changes the custom element for the selected guide. The original custom element remains unchanged for all other guides.

  • The card only appears if your account has more than one guidebook and at least one Custom Element.

  • The new Hub doesn't have a per-guide screen yet, so you can't see or edit per-guide values there. Values you already set per guide in the legacy Hub still apply to that guide. To change them, switch back to the legacy Hub (see How to switch between the new and legacy Hub). Note that if you're an owner, admin or team admin, switching to the legacy Hub also turns Guidebook 2.0 off.

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

Related Articles
Did this answer your question?