Your booking widget's URL accepts parameters that preselect what a guest sees — an activity, a category, a date, or a particular view. Add them to a widget link (or the shareable URL from the Install screen) to send guests exactly where you want: a "Book this tour" button on a specific activity page, a campaign link that opens on the calendar, or a localized link for an international audience.
In this article
Add parameters to the link like any query string — the first with ?, the rest joined by &:
https://yourbrand.tripworks.com/widget/<widget-id>?experience=123&defaultView=calendar
What you can preselect
-
experience— open straight to a specific activity. -
category— preselect a category. -
date— open on a specific date. -
defaultView— which view to load:catalog,calendar,agenda,categories, orgiftCards. -
language— load the widget in a specific language. -
lightframeMode— open the booking flow in a lightframe (modal overlay). -
chooseDateLater— start in flex booking (book now, pick the date later). -
hideNav— hide the widget's top navigation for a cleaner embed. -
showPrices/showTicketPrices— show pricing on the calendar / time slots. -
catalogItemLayout— catalog card layout:default,compact, orexpanded. -
resource— preselect a specific resource (a particular boat, guide, or vehicle), so the widget opens already filtered to activities tied to it. -
reseller— attribute bookings made through this link to a specific reseller, by their reseller code. Give each partner or affiliate their own link with their code baked in, and their bookings are tagged to them automatically. Find or set a reseller's code from their reseller record.
Common examples
-
Link a tour page to its activity:
…/widget/<id>?experience=<activityId> -
Open on the availability calendar:
…/widget/<id>?defaultView=calendar -
A localized campaign link:
…/widget/<id>?language=es -
A trackable link for a specific reseller:
…/widget/<id>?reseller=<resellerCode>
Frequently asked questions
Can I link directly to one activity?
Yes — add ?experience=<activityId> to the widget URL and it opens straight to that activity's booking. Ideal for a "Book" button on that tour's page.
Can I preselect a promo code in the link?
No — promo and voucher codes are entered by the guest at checkout, not passed in the URL. You can preselect the activity, date, category, and view.
Do these work with an embedded widget too?
Yes. They work on the shareable widget URL and are also read by the embedded widget, so a link into your embedded booking page can preselect the same things.
Can I give a reseller or affiliate their own trackable booking link?
Yes. Add ?reseller=<code> with that reseller's code, and bookings made through that link are attributed to them automatically. Useful for partners you want to track without them logging into anything.
Can I preselect a specific guest count or ticket type in the link?
Not today. You can preselect the activity, date, category, view, resource, and reseller, but the guest picks ticket types and quantities themselves once the widget opens.
Related
Built for attractions, tours & activities
Send guests straight to "Book"
See how attractions, tours, and activities turn every link into a booking with TripWorks. Book a demo and make the switch.