Widget customization parameters | Triparound Help Center

Triparound widgets provide flexible configuration options that allow control over which products are shown, how booking flows behave and how conversion tracking can be enabled across guest-facing touchpoints.

Parameters can be applied individually or combined to create flexible booking flows and tailored display behavior depending on the widget type.

Learn how to configure embedded and standalone widgets using data attributes and query parameters.

Data attributes are used for embedded widgets, while query parameters are used for standalone (URL) widgets.

Overview

Triparound widgets support three primary filtering modes to control which products are displayed in the widget.

Choose a single filter or combine multiple filters depending on the widget type.

Parameter Type	Data Attribute	Query Parameter	Widget Type	Format
Activity ID	data-activityId	activity_id	Multi-product	Comma-separated IDs
Product ID	data-pid	product_id	Single-product	Single ID
Category ID	data-cid	category_id	Multi-product	Comma-separated IDs

Notes:

Multi-product widgets display multiple products.
Single-product widgets display one specific product.
Activity IDs and Category IDs can be combined in the same widget.
Under normal circumstances, parameters are defined during widget setup.
If no parameters are defined, the widget displays all products connected to the business.

Widget Display Controls

Control core widget behavior, including business context, visible tabs, layout mode and language.

Defines how the widget appears and behaves across embedded and standalone environments.

Parameter	Data Attribute	Query Parameter	Description	Values
Business ID	data-bid	business_id	Business identifier	String
Show Products	data-show_products	show_products	Show “Things to Do” tab	true, false
Show Transfers	data-show_transfers	show_transfers	Show “Transfers” tab	true, false
Standalone	data-standalone	standalone	Full-screen mode	true, false
Language	data-lang	locale	Product content language	ISO code

Notes:

These parameters are typically configured during widget setup.
show_products and show_transfers only apply to multi-product widgets.

Guest Prefill Parameters

Optionally prefill guest details during checkout to streamline the booking process.

Used to personalize the booking experience and reduce manual input for returning or known guests.

Parameter	Data Attribute	Query Parameter	Description	Format
First Name	data-firstName	firstName	Customer first name	String
Last Name	data-lastName	lastName	Customer last name	String
Email	data-email	email	Email address	Email
Mobile	data-mobile	mobile	Phone number	String
Nationality	data-nationalityCode	nationalityCode	ISO nationality code	ISO code

Stay & Booking Context Parameters

Connect bookings with PMS data and guest stay information for a more integrated experience.

Enables accurate mapping of reservations, room details, and stay dates to booking flows.

Parameter	Data Attribute	Query Parameter	Description	Format
Guest ID	data-guestId	guestId	PMS guest ID	String
Room Number	data-room	room	PMS room number	String
Reservation ID	data-reservationId	reservationId	PMS reservation code	String
Arrival Date	data-arrivalDate	arrivalDate	Stay start date	YYYY-MM-DD
Departure Date	data-departureDate	departureDate	Stay end date	YYYY-MM-DD

Notes

reservationId must already exist in the PMS for Triparound to map the booking.
Arrival and departure dates restrict booking calendars to the guest’s stay dates only.

Upselling & Tracking Parameters

Support attribution, promotions and conversion tracking across touchpoints.

Helps link bookings to marketing sources and apply valid discount incentives.

Parameter	Data Attribute	Query Parameter	Description	Format
Referral Source	data-referralSource	referral_source	Booking source tracking	String
Coupon	data-coupon	coupon	Discount coupon	String

Notes

referralSource can be configured during widget setup for booking attribution.
The coupon appears at checkout and must already exist in Triparound before use.