GetYourGuide Listeo Integration: Client Guide
Complete operating guide for GetYourGuide URLs, widgets, related tours, price sync, price history, and license management.
This plugin connects a Listeo listing to a specific GetYourGuide tour. Add the GetYourGuide URL to the listing Website field, then use the Elementor widget, shortcode, related tours grid, or price sync tools.
What this plugin does
GetYourGuide Integration for Listeo reads a GetYourGuide URL from a Listeo listing, extracts the tour ID from that URL, and uses the tour ID to display a GetYourGuide booking widget or update the listing minimum price.
It does not automatically discover tours from a listing address. Each listing that should show a GetYourGuide widget must have a valid GetYourGuide URL, normally one that contains a tour ID such as -t392501.
Use the Elementor widget named GetYourGuide Availability inside your single listing template.
Use [gyg_tour] when you want a GetYourGuide booking card inside a normal WordPress post or page.
Enable the related tours grid to show random GetYourGuide widgets from other listings on your site.
Run manual or scheduled price sync and review every result in Price History.
Requirements
- WordPress 5.8 or newer.
- PHP 7.4 or newer.
- Listeo or a Listeo child theme active.
- Administrator access to WordPress.
- A valid plugin license if your package requires activation.
- Outbound HTTPS access from the server.
- At least one published Listeo listing with a GetYourGuide URL in the Website field.
Install and activate
- Upload the plugin. Go to Plugins > Add New > Upload Plugin, upload the ZIP file, and install it.
- Activate it. Click Activate after WordPress finishes installing the plugin.
- Open the plugin area. Go to ListingPilot > GYG Integration.
- Activate the license. Open the License screen, enter your key, and click Activate License.
- Save settings once. Open Settings, confirm the defaults, add your Partner ID if you use affiliate tracking, and save.
Configure settings
Open ListingPilot > GYG Integration > Settings. These settings are global defaults used by the Elementor widget, shortcode, related grid, preview, and price sync.
| Setting | Use it for | Good starting value |
|---|---|---|
| Locale Code | Widget language and regional formatting. | en-US, el-GR, de-DE |
| Currency | Widget currency and price sync currency. | EUR |
| Widget Type | GetYourGuide widget mode. | Availability Calendar |
| Layout Variant | Widget orientation. | Vertical |
| Partner ID | Affiliate tracking and commission attribution. | Your GetYourGuide partner ID |
| Preview Tour URL | Admin preview only. | A known working GetYourGuide URL |
Add GetYourGuide URLs to listings
- Open a listing. Go to Listings > All Listings and edit the listing.
- Find Website. Locate the Listeo Website field.
- Paste the full URL. Use a GetYourGuide activity URL that contains a tour ID.
- Update the listing. Save the listing and open it on the frontend.
https://www.getyourguide.com/corfu-l405/corfu-aqualand-water-park-entry-ticket-t392501/If the listing has no GetYourGuide URL or the URL does not contain a tour ID, the widget may render nothing. This avoids showing broken booking blocks to visitors.
Show the widget with Elementor
- Open the Listeo single listing template in Elementor.
- Search for GetYourGuide Availability.
- Drag it where you want the booking widget to appear.
- Save the template.
- Visit a published listing that has a GetYourGuide URL in the Website field.
The widget reads the current listing, extracts the tour ID, and loads the GetYourGuide widget using your global locale, currency, partner ID, widget type, and layout variant.
Use the shortcode
Use [gyg_tour] in posts or pages. For single listing templates, the Elementor widget is usually the better choice.
[gyg_tour tour_id="392501"]
[gyg_tour listing="corfu-aqualand-water-park-1-or-2-day-entry-tickets"]
[gyg_tour listing_id="456" title="Aqualand Water Park" variant="vertical"]
[gyg_tour tour_id="392501" trust="yes"]| Attribute | Purpose |
|---|---|
tour_id | Use a specific GetYourGuide tour ID directly. |
listing | Use a listing slug and read the tour from that listing. |
listing_id | Use a numeric listing ID and read the tour from that listing. |
title | Override the booking card title. |
variant | Use vertical or horizontal. |
trust | Use yes to show trust bullets below the card. |
Related tours grid
The related grid is optional. It shows random GetYourGuide widgets from other published listings that already have GetYourGuide URLs.
- Go to GYG Integration > Settings.
- Enable Related GetYourGuide tours (automatic).
- Choose All listings or Per category.
- Choose the matching taxonomy, usually
listing_category. - Select widget counts, columns, and placement positions.
- Save settings.
Displays before the listing description.
Displays after the listing description.
Displays above sidebar booking widgets.
Displays below sidebar widgets.
In Per category mode, edit the relevant listing category and enable the GetYourGuide related tours grid checkbox for that term.
Price sync
The plugin can fetch a GetYourGuide price and update the Listeo minimum price field. Every attempt is logged in Price History.
Run it from Settings by clicking Update All Prices Now. It scans published listings with getyourguide.com in the Website field.
Enable Auto-Sync and choose Every Hour, Twice Daily, or Once Daily. It uses WordPress cron.
Price fetching depends on GetYourGuide widget HTML and server access. It can fail if GetYourGuide changes markup, blocks the request, or the tour has no readable availability price.
Price History
Open ListingPilot > GYG Integration > Price History to review update attempts. The table shows date, listing, old price, new price, change, source, status, and action links.
- updated: the listing price changed.
- no_change: the fetched price matched the existing listing price.
- failed: the plugin could not fetch a usable price.
You can filter records by status or source and export them as CSV.
Troubleshooting
| Problem | Most likely cause | Fix |
|---|---|---|
| Widget does not appear. | Missing or invalid GetYourGuide URL. | Add a full URL containing -t123456 to the listing Website field. |
| Widget appears in Elementor but not on the frontend. | Cache, optimization, or external script blocking. | Clear cache and confirm the GetYourGuide widget script loads. |
| Price sync fails. | GetYourGuide did not return a readable price or the server request failed. | Check the URL, test another tour, confirm outbound HTTPS, and review Price History. |
| Automatic sync is late. | WP-Cron is not triggered frequently. | Ask the host to configure real server cron for WordPress. |
| Related grid does not show. | Grid disabled, no tour pool, or category mode not configured. | Add more GetYourGuide listings and enable the category checkbox if using Per category. |
Support handoff
When contacting support, include the site URL, plugin version, Listeo/theme version, affected listing URL, GetYourGuide URL from the Website field, screenshots of settings, and the failed Price History row if price sync is involved.