Skip to main content

Connect to GetYourGuide (GYG)

Set up the GetYourGuide integration to automatically sync availability and receive bookings from GetYourGuide in Understory.

Connecting Understory to GetYourGuide (GYG) lets you receive bookings from GetYourGuide's marketplace without any manual work. When a guest books on GetYourGuide, the booking appears in Understory automatically — just like any other booking — and your availability updates instantly across both platforms, so you never get double bookings.

A few things to know upfront

  • Availability syncs from Understory to GetYourGuide — Understory is the source of truth.

  • Prices are set independently in GetYourGuide — they are not synced from Understory.

  • Guest communication for GetYourGuide bookings is handled entirely by GetYourGuide — Understory won't send confirmation emails for these bookings.

  • The integration links experiences that already exist in both systems — it does not create them for you.

Before you start

Make sure you have:

  1. A GetYourGuide Supplier account. If you don't have one yet, you can sign up at getyourguide.supply.

  2. Your experiences in both systems. Any experience you want to sell on GetYourGuide must also exist in Understory. It's fine to have Understory-only experiences, but you can't connect a GetYourGuide experience that doesn't exist in Understory.

  3. Ticket types set up in Understory — at minimum an Adult ticket. Your Understory tickets will be mapped to GetYourGuide ticket types during setup.

Part 1: Connect Understory to GetYourGuide (one-time)

This only needs to be done once per company account.

  1. Go to Integrations. Click your company name / profile icon in the bottom-left corner to open Company settings, then open the Integrations tab. You'll see GetYourGuide listed.

  2. Click "Get started" on the GetYourGuide card. In the dialog that appears, click Ready to connect.

  3. Authorize the connection. Sign in with your Understory credentials to authorize the connection. This is a standard one-time sign-in. You'll then be redirected back to the Understory backoffice.

  4. Confirm. After login you'll land on Company settings > Integrations > GetYourGuide, showing all your live Understory experiences. Your account is now connected.

Part 2: Set up each experience in Understory

Repeat this for every experience you want to sync with GetYourGuide.

Step 1: Map your tickets

From the GetYourGuide integration dashboard, click the experience you want to connect, then click + Product ID. If your tickets haven't been mapped yet, the Match tickets first dialog appears.

GetYourGuide uses fixed ticket types instead of custom names, so you tell Understory which of your tickets matches which GetYourGuide type:

  • Don't sync — ticket stays on Understory only, not visible on GetYourGuide

  • Adult — standard adult (required, at least one ticket must use this)

  • Child, Youth, Infant, Senior, Student, EU Citizen — use as relevant

Rules to follow

  • Adult is mandatory — at least one ticket must map to Adult.

  • Each GetYourGuide type can only be used once. If you have two adult-like tickets, map one to Adult and the other to a different type (e.g. Senior).

  • All tickets need a mapping. Use "Don't sync" for any ticket that shouldn't appear on GetYourGuide.

  • If your experience has only one ticket type, the mapping may be done automatically.

Once everything is mapped, click Continue. You can review or change mappings later from the experience detail page via Ticket settings.

Step 2: Create a product option

After mapping tickets, the Create a product ID dialog appears. Fill in:

  1. Name — auto-filled as [Location]: [Experience name], [X] languages. You can edit it.

  2. Location — which Understory location this product option covers.

  3. Language — which language(s) this product option covers. Select No language if you haven't set languages on your events in Understory — GetYourGuide will then receive availability for all events.

Click Complete. If you run the same experience at different locations or in different languages, create one product option per variation — each gets its own unique product ID.

Step 3: Copy the product ID

The Your product ID is ready dialog shows a product ID (a long code such as 11a05f33-e958-4800-8ef1-bfe47c9e7fa9) with a copy icon. Copy it now — you'll paste it into GetYourGuide in the next part. You can always retrieve it later from the experience detail page using the copy icon next to the product option.

Part 3: Enter the product ID in GetYourGuide

Switch to your GetYourGuide Supplier portal.

  1. Go to Manage > Products and click the product that matches your Understory experience. Products that aren't live yet (shown as "Not yet submitted") can still be connected — you don't need to wait until the product is published.

  2. Open Connectivity Settings. Inside the product, use the left sidebar: Options > Edit option > Connectivity Settings.

  3. Select "Yes, I use a reservation system".

A warning dialog will appear about deleting pricing data.

  • First-time setup: safe to confirm — no pricing data exists yet.

  • Existing product with prices: your GetYourGuide prices will be cleared and must be re-entered after connecting. Note them down first.

Click Yes, delete all pricing data to continue. (Choosing "No, retain settings" cancels the switch to a reservation system.)

  1. Select "Understory" from the Reservation System dropdown.

  2. Paste your product ID into the External product ID field and click Continue. Settings save automatically — this product option now syncs availability from Understory in real time.

  3. Add your prices in GetYourGuide under Availability & Pricing. Prices are independent from Understory, so many operators set a slightly higher price on GetYourGuide to account for GetYourGuide's commission.

  4. Repeat Parts 2–3 for each experience and product option you want to sync.

How the integration works once connected

  • Availability syncs instantly. Events created, updated, or booked in Understory push to GetYourGuide immediately. GetYourGuide also polls availability on a regular schedule as a backup.

  • Bookings flow into Understory. GetYourGuide bookings appear in your normal bookings list, labelled as coming from GetYourGuide.

  • GetYourGuide handles guest communication. Confirmations and reminders for GetYourGuide bookings are sent by GetYourGuide, not Understory. This is expected.

  • Prices are managed in GetYourGuide only and are not synced from Understory.

  • Cancellations restore availability. When a GetYourGuide booking is cancelled, the availability is freed up again in Understory automatically.

Good to know

  • Only time-based experiences are supported. Experiences with specific start times work with GetYourGuide. Full-day activities, open tickets, and experiences without a defined start time are not currently supported.

  • Private events are not synced. Events set to Private in Understory are deliberately excluded from GetYourGuide, so their availability won't appear there and GetYourGuide bookings can't be received for them. Product IDs can't be created directly for private events.

  • French and Spanish aren't supported as experience languages yet. If a GetYourGuide product has options in these languages, map them to No language when creating the product ID. They'll then share the same capacity pool as events without a language set. (Dedicated French/Spanish support is on the roadmap.)

  • Ticket multiples. If your Understory experience requires bookings in fixed multiples (e.g. pairs), GetYourGuide can still send an odd participant count. Understory rounds up to the nearest allowed multiple. This works best when your pricing is per group.

Tips

  • Minimum participants. Understory doesn't enforce a minimum participant count automatically. To communicate one, add it to your experience description and to Additional booking information (Experience > Settings) so it appears in the guest's confirmation. You can also set a booking cut-off (Experience > Settings > Close bookings before event starts) to give yourself time to confirm or cancel a shared tour before it runs.

  • Per-language capacity. If you need separate capacity per language on GetYourGuide, create one Understory event per language, each with its own product ID. As a cleaner alternative, run one event per language with a dedicated guide assigned as a resource — this keeps your backoffice manageable while still splitting capacity.

  • Deposits / partial payments. Understory doesn't support split payments natively. As a workaround for larger private bookings, create a "Deposit" ticket at the deposit amount and note in the booking information that the remaining balance is due at the meeting point.

How to disconnect

Go to Company settings > Integrations > GetYourGuide, click the three-dot menu, and choose Disconnect.

Note: Disconnecting resets all ticket mappings and product IDs. Everything will need to be reconfigured from scratch if you reconnect.

Did this answer your question? If not, please reach out to us in the chat window in the bottom-right corner and we'll be happy to help.

Did this answer your question?