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