> ## Documentation Index
> Fetch the complete documentation index at: https://docs.obvlo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Embeddable Widget (Trip Planner) Features

> Modular JavaScript component that delivers personalised recommendations on any webpage.

# Embeddable Widget (Trip Planner) Features

> [!NOTE]
>
> Use [Embeddable Widget](/product/delivery/embeddable-widget) for implementation overview. Use this page for detailed feature reference.

The Embeddable Widget is a modular JavaScript component that delivers personalised recommendations on any webpage that supports JavaScript. It is installed with 2 lines of HTML: one line loads the widget engine (header), and one line renders content (where the widget should appear). It uses destination content and personalisation from the Obvlo system.

## Features

| Feature | What It Does | Key Capabilities |
| - | - | - |
| **Widget Configuration** | Configure styling, behaviour, and layout via HTML attributes or Portal editor. | Styling: container max widths, padding, border radius, custom icons for featured guides; Behaviour: toggle animation, saved feature, travel times, force personalisation, kiosk mode, drawer mode; Layout: control which cards display, card order, result rows per device; Portal editor with real-time preview before publishing |
| **Widget Main Page** | Configurable homepage built from four card types. | Header Banner Card: dynamic weather display, location, logo, changeable banner image; Menu Card: category filter, search, saved list access; Grid Card: grid view of individual listings; List-Map Card: split list and map view; Cards selectable and reorderable via Portal or HTML attributes |
| **Search** | Free text search accessible via Menu Card. | Searches listings in the destination database; Returns listing results matching the search term; No Google Places fallback in widget; No results message displayed when no listings match |
| **Saved List** | Save listings within widget without account. | Save listings from compact CTA bar on Listing Pages; Saved list accessible via Menu Card; Listings removable from saved list anytime; No account required |
| **Map** | Interactive map centred on destination with search and clustering. | Centred on destination geocoordinates as fixed focal point; Typesense free-text search for listings directly on map; Proximity clustering: nearby markers group, click to expand; Co-location modal: listings at identical coordinates grouped in popup modal |
| **Content Pages** | Secondary pages (Listing Page and Guide Page) inside widget. | Compact CTA bar with quick actions: directions, back, save; Fixed layout (not configurable) for consistent presentation across all implementations; No redirect required |
| **Widget Personalisation** | Preference capture flow for personalised content. | Questions on travel type, purpose, interests; Main Page content re-ranked and filtered based on responses; Accessible without redirect; Responses feed into Widget Insights; Supports browser auto-detection and manual language selection |
| **Drawer Mode** | Side button that expands into full overlay widget. | Compact button anchored to page edge with minimal footprint; On click, expands into full widget as overlay; Existing page content remains visible beneath; No redirect or page disruption; Configurable button appearance and trigger delay |
| **Widget Insights** | Google Analytics-powered engagement and demographic data. | Acquisition Insights: number of active users on widget; Engagement Insights: avg sessions, returning users, personalised users, listing/guide views; Demographic Insights: guest language and country from device details; Custom GA tag configurable per customer |

***

## Future Updates

When new Widget features are released, simply add a new row to the table above.

## Related

* [Portal Features](/product/management/portal-features) — Configure Widget settings from Portal
* [HTML Pages](/product/delivery/html-pages-features) — Alternative low-integration delivery option
* [Reporting](/product/insights/reporting-features) — View Widget engagement data


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.