Skip to content

⚠️ Recent Visits is in beta. All listings and data shown are for demonstration purposes only and do not represent real or verified information. Tour listings are based on content from partner agencies’ websites and have not yet been confirmed by the agencies.

Recent Visits

Widget Studio field reference

Every screen, tab, field and button of the Website widget page in the agency portal: websites and keys, settings, draft and publish, live preview, and what owners and managers can see.

On this page

Overview#

The Widget Studio is the Website widget page of the agency portal. It is where you register the website that shows your widget, copy the script tag, and set the look and behaviour of the chat without writing code. A live preview of the real widget sits next to the settings.

Who can use it#

RoleWhat they see and can do
OwnerThe full Studio: all tabs, Save draft, Publish, the live preview, and on the Install tab register or change a domain, switch an environment on or off, and revoke its key.
ManagerA notice "Only agency owners can change the widget settings." and a read-only Your websites card for each environment: its status, registered domain, snippet, address and public key. No preview, no settings.

If an environment is not set up, a manager sees "Only agency owners can set this up." Server actions re-check that the person is an owner of the agency, so the restriction does not depend on what the page shows.

How to open it#

  1. Sign in to the agency portal.
  2. In the left menu, under Assistant and website, choose Website widget (/partner/integrations).

Layout#

  • On a wide screen the settings are on the left and the Live preview on the right (it stays in view while you scroll). On a narrow screen the preview goes below the settings.
  • The settings have eight tabs: Overview, Branding, Colors, Launcher, Messages, Behavior, Features and Install. On a phone the tab row scrolls sideways.
  • A tab that contains a field with a problem shows a small number badge ("to fix" for screen readers).
  • A bar at the bottom of every tab except Install holds Save draft, Publish, Discard edits, Discard draft (only when a draft exists) and Reset look to defaults, with a status line.
The Website widget page in the agency portal: the section tabs, the Save draft and Publish buttons and the live preview of the real widget.
The widget studio. 1 Sections. 2 Save draft shows it on your test website. 3 Publish makes it live. 4 The live preview.

Settings are shared by both environments#

One set of settings belongs to your agency and is used by both your Production and Test websites. What differs is which version each one serves:

EnvironmentServes
ProductionThe published settings only.
TestYour saved draft if there is one, otherwise the published settings. "Talk to a person" is always off on Test.

Overview tab#

Field or itemTypeRequired?ExplanationHow to use it
Production websiteStatus + domainNoBadge Not set up, Active or Switched off, with the registered domain.Read only. Change it on the Install tab.
Test websiteStatus + domainNoThe same for the Test environment.Read only.
SettingsStatus badgeNoUnsaved changes (edited since the last save), Draft saved, not published, or Published. A draft also shows when it was saved.Use it to see whether visitors on production have your latest edits.
Conversations (30 days)NumberNoWidget conversations started in the last 30 days (from your 200 most recent conversations).A quick measure of use. Details are under Conversations.
With a quote requestNumberNoOf those, conversations that led to at least one quote request.Compare with the first number.
Taken over by your teamNumberNoOf those, conversations where a team member replied.Shows how often visitors reached a person.
ChecklistFour checksNoProduction website registered; Widget switched on; Look customised and published; First visitor conversation.Work down the list until all four are done.

Branding tab#

Field or itemTypeRequired?ExplanationHow to use it
Assistant nameTextNoShown above the assistant's messages. Up to 40 characters. Blank uses AI Travel Assistant.Keep it recognisable as an AI assistant.
Chat titleTextNoThe header title. Up to 60 characters. Blank shows your agency name.Leave blank unless you want different wording.
Chat subtitleTextNoThe line under the title. Up to 80 characters. Blank uses AI travel assistant.Short and plain.
Show my agency logo in the chat headerSwitchNoWhen on and your profile has a logo, the logo appears in the header. On by default until you first save. Below it the Studio checks the logo: over https, at least 96 px, roughly square, and warns ("Small", "Not square", "could not be loaded").Turn off to show the launcher icon instead. Logos are changed through your profile (see Profile).
The Branding tab of Widget Studio with its fields on the left and the live preview on the right.
The Branding tab. Changes show in the live preview before you publish.

Colors tab#

Colours you pick are kept readable automatically; a warning tells you when visitors will see a different shade. Blank uses the default. Details are in Themes and agency branding.

The Colors tab of the widget studio with the main colour, the accent colour and the light or dark setting, next to the live preview.
The Colors tab. 1 Main colour. 2 Accent colour. 3 Light or dark.
Field or itemTypeRequired?ExplanationHow to use it
Main colour#rgb or #rrggbbNoHeader, launcher and your visitors' messages. Default #0b5c4a. Validation message: "Use a colour like #0b5c4a." Warning if it is under 3:1 against white: "Very light on a white page".Type a hex value or use the colour picker.
Accent colour#rgb or #rrggbbNoActive tab, bullets and highlights. Defaults to the main colour. Warning under 3:1 against white: "Too faint on white ... visitors see a deeper shade than you picked."Pick a deeper shade if you see the warning.
Light or darkSelectNoMatch the visitor's device (auto, default), Always light, Always dark.auto follows the visitor's system.
Rounded cornersSlider, 0 to 28 pxNoCorner radius. Untouched it shows "Default (14)" and saves nothing; the widget itself defaults to 16 (see the note below). Use the default clears it.Move the slider to set a value.

Launcher tab#

Field or itemTypeRequired?ExplanationHow to use it
Launcher textText, up to 30NoText on the button. Blank shows the icon only. On screens 480 px wide or narrower it shrinks to the icon.For example "Ask our travel guide".
Launcher sizeSlider, 44 to 72 pxNoSize of the button. Default 56. Use the default clears it.Validation: "Enter a number from 44 to 72."
Launcher iconRadioNoCompass (default), Chat bubble (chat), Sparkle.Pick the one that suits your site.
Side of the screenRadioNoRight (default) or Left.Choose the side that clears your own floating buttons.
The Launcher tab of the widget studio, with the launcher text, icon, size and position, next to the live preview.
The Launcher tab. 1 The text on the button. 2 Its size.

Messages tab#

Field or itemTypeRequired?ExplanationHow to use it
Welcome messageText area, up to 400NoThe first message in the chat. Blank uses the greeting below, or Hi! I can help you with <agency>. What would you like to know?.Write one or two friendly sentences.
Greeting (optional)Text, up to 300NoUsed when there is no welcome message.Leave blank if you use a welcome message.
Show a small invitation next to the buttonSwitchNoOff by default. When on, a short invitation appears beside the launcher: at most once per visit, not again after it is closed, never after the chat has been opened. No browser notifications.Turn on only if you want it.
Invitation textText, up to 120NoDisabled until the switch is on. Blank uses Planning a trip? Ask me anything.Keep it short.
Show after (seconds)Number, 1 to 120NoDisabled until the switch is on. Blank means 10 seconds. Validation: "Enter a number from 1 to 120."Use a longer delay so it does not interrupt.
The Messages tab of Widget Studio with its fields on the left and the live preview on the right.
The Messages tab. Changes show in the live preview before you publish.

Behavior tab#

Field or itemTypeRequired?ExplanationHow to use it
How the assistant soundsSelectNoFriendly (default) or Professional.Choose the tone for your brand.
Suggested questionsText areaNoOne per line, at most 4, each up to 70 characters, shown as buttons under the welcome message. Validation: "At most 4 suggestions." Without any, the widget offers two built-in starters.Write the questions travellers ask most.
Let the assistant give out my agency's phone number, email and addressCheckboxNoOff by default. Your website address and profile link are always shared.Turn on only if you are happy for the assistant to share contact details.
Visitors can ask to talk to someone from my teamSwitchNoOn by default. Visitors can ask for a person; you take over from Conversations; the assistant stays quiet while you write and returns after 15 minutes without a reply. A request nobody picks up within 10 minutes expires and the quote form is offered. Never on Test.Turn off if nobody can answer chats.
Always available / Only during office hoursRadioNoOnly shown when the switch is on. Outside office hours visitors are offered the quote form.Choose Only during office hours to set a schedule.
Time zoneTextNoOnly for office hours. An IANA name, default Asia/Kathmandu. An unknown zone is refused ("Unknown time zone").Use the zone of your office.
Monday to SundayText per dayNoHours such as 09:00-17:00, or several ranges separated by commas (up to 3 per day). Blank means closed that day. Messages: "Use hours like 09:00-17:00 (mon)." and "Start must be before end".Enter 24-hour times.
The Behavior tab of Widget Studio with its fields on the left and the live preview on the right.
The Behavior tab. Changes show in the live preview before you publish.

Features tab#

Field or itemTypeRequired?ExplanationHow to use it
Assistant chatSwitchNoVisitors ask questions and get answers from your own data. The chat feature.Turn off to hide the Chat tab.
Tour listSwitchNoShows your published tours with indicative prices (the tours feature).Turn off to hide the Tours tab.
Quote requestsSwitchNoA short form that sends a quote request to your Leads (the quote feature).Turn off to hide the Quote tab and buttons.
The Features tab of Widget Studio with its fields on the left and the live preview on the right.
The Features tab. Changes show in the live preview before you publish.

At least one must stay on: "Choose at least one feature." Turning one off hides it from visitors; the assistant still answers only from your data. "Talk to the agency" is not on this tab; it is on Behavior.

Install tab#

The Install tab shows one card per environment and has no Save or Publish bar. Registering a domain takes effect at once; it does not need publishing.

The Install tab of the widget studio showing the embed snippet with the public key blurred, and a Copy snippet button.
The Install tab. 1 The snippet to paste into your website. 2 Copy it. The key is blurred here.
Field or itemTypeRequired?ExplanationHow to use it
Status badgeBadgeNoNot set up, Active, Switched off.Read only.
Register your website / Website domainTextYes (to register)A domain such as youragency.com. A scheme, path and leading www. you paste are removed. Subdomains are covered, over https, on the default port. Test may instead be localhost or 127.0.0.1 (http, any port). The Studio shows what it will register and rejects wildcards, ports, other IP addresses, single names and shared suffixes such as github.io. Production cannot be localhost.Type the domain. The button is disabled until it is valid and different from the saved one.
Register website / Change domainButton-Creates the environment with a new public key, or changes the domain of the live one. Success message: "Saved. Copy the snippet below."Click once the helper text shows what will be registered.
Add this to the production / test websiteCode block-The script tag with your key. Off the production address it also contains data-api-base. Keyboard focusable.Copy it with Copy snippet.
Widget address (API base) and Public keyRead-only details-Shown in full in the portal. The key is not a password and only works on the registered domain. Test shows your draft; Production shows what you published.Use the key if you build your own client (API reference).
Switch off / Switch onButton (owners)-Switching off stops the widget at once on that website; switching on restores it.Use it to pause the widget temporarily.
Revoke this key (register again for a new one)Button (owners)-Permanent. A revoked key cannot be switched back on; the environment shows Not set up and registering again creates a new key.Use if a key is misused. Then update the snippet on your site.

Save draft, Publish and the other buttons#

Field or itemTypeRequired?ExplanationHow to use it
Save draftButtonNoStores your edits as a draft. The Test website shows it (within about a minute); production does not change. Message: "Draft saved. Your test website shows it now; production is unchanged until you publish."Use it to try changes on your test site.
PublishButtonNoMakes the settings live for production and clears the draft. Message: "Published. Visitors on your production website see it within about a minute."Use it when the test site looks right.
Discard editsButtonNoThrows away edits not yet saved and returns to the last saved state. Disabled when nothing changed.Use it to undo typing.
Discard draftButtonNoOnly shown when a draft exists. Deletes it on the server; the Test website returns to the published settings and the form shows them.Use it to abandon a draft.
Reset look to defaultsButtonNoClears every branding field in the form (colours, launcher, names, messages, suggested questions, invitation) and turns the logo switch on. It does not save; press Save draft or Publish.Use it to start the look again.

If a field is invalid, the Studio jumps to the first tab with a problem and focuses the field. The browser warns before you leave the page with unsaved edits. Saving is limited to 60 times per hour per agency.

Live preview#

Field or itemTypeRequired?ExplanationHow to use it
Status pillLabelNo"Unsaved changes, not live", "Draft: on your test website only" or "Published, live on your website".Read only.
Desktop / MobileToggle buttonsNoChanges the frame width (the mobile frame is 24 rem wide).Check the full-screen mobile layout.
As saved / Light / DarkToggle buttonsNoOverrides light or dark in the preview only, to check both.Visitors get what Light or dark says.
Open chat / Close chatButtonsNoOpens or closes the preview's chat panel.Try the Chat, Tours and Quote tabs.
Replay invitationButtonNoShows the invitation again if it is switched on.Check its text and timing.
The real widget chat panel, opened in the preview: header with the agency name, the Chat, Tours and Quote tabs, a welcome message and suggested questions.
The chat panel as visitors see it, with the Chat, Tours and Quote tabs.

The preview runs the real widget with a stand-in connection, in a frame on the same address. Replies and the tour are placeholders ("This is a preview..."), "Talk to the agency" is unavailable, and nothing is sent or saved. It updates as you type.

What the Studio does not set#

Colours for dark mode only (themeDark), the font, the offset from the screen edge, avatar images, contextual invitations and the page context cannot be set in the Studio. Pass them in your page; see Configuration reference. Server-delivered settings can style the widget only: they never switch features, page context or location-based invitations on.

Mobile and responsive behaviour#

On a phone the tab row scrolls sideways and the preview is below the settings.

The widget studio on a phone, with the section tabs at the top that scroll sideways.
The widget studio on a phone.

Troubleshooting#

SymptomCause and fix
"Only agency owners can change the widget settings."You are a manager. Ask an owner.
The Register button is disabledThe domain is empty, invalid, or the same as the saved one.
"The production website must be a real domain..."You entered localhost on Production. Use it on Test.
My change does not show on the live siteYou saved a draft. Press Publish; allow about a minute.
The logo does not showThe logo switch is off, the profile has no logo, or it is not https.

How to set the widget up#

  1. Open Website widget and go to Install. Register your Test domain (for example localhost) and copy its snippet.
  2. Edit the Branding, Colors, Launcher, Messages, Behavior and Features tabs, watching the preview.
  3. Press Save draft and check your test site.
  4. Register your Production domain and copy its snippet into your live site.
  5. Press Publish.

Last checked against the product:

  • Agency integration guide · How the widget knows which agency it belongs to, how environments and drafts work, how quote requests reach your portal, and a go-live checklist.
  • SDK installation · Install the Recent Visits widget with a script tag, add Subresource Integrity, run it locally, and understand the current npm status.
  • Themes and agency branding · Colours, dark mode, corner radius, fonts, launcher and logo for the Recent Visits widget, how contrast is enforced, and what cannot be styled.
  • SDK configuration reference · Every option the Recent Visits widget accepts: type, default, limits and an example. Invalid values are replaced by safe defaults.

Still stuck? Contact us and tell us what you tried.