---
title: "Widget settings"
url: "/help/buuk/widget-settings"
updated: "2026-11-15T11:35:30.704Z"
---
# Widget settings

Open Settings → Help widget to control how the widget behaves without touching your install snippet. There is one widget per workspace, and this page saves as you change it.

The page has three tabs: Setup, Appearance, and Escalation. Look and feel is not here any more — it moved to the Widget studio.

## Setup

Enable widget turns the widget on and off everywhere at once: the embed stops working, the direct chat link returns not found, and the studio preview can't load your articles. New widgets start turned off, so a fresh workspace has to switch this on after installing the snippet.

Allowed origins lists the websites the widget may load articles on, one per line, such as https://app.yourproduct.com. The widget still opens on an unlisted site, but its article calls are refused. Local development skips the check.

Public key identifies the workspace. It starts with wk_ and carries no secret, so it is safe in a public page. Rotate key issues a new one and stops the old one immediately, which breaks any site still running the previous snippet until you paste the new one.

Embed snippet is the script tag to paste into your product. Direct chat link is a full-page hosted version at /widget/<key> that needs no install.

## Appearance

This tab is now a doorway. Open widget studio covers the logo, icon, launcher, colours, gradients, theme, font, greeting, Home links and product updates, with a live preview of the real widget.

Voice replies stays here. Turn it on to add a Listen button to AI answers, pick a voice, preview it, and choose whether answers play automatically. Voice is opt-in for readers either way.

## Escalation

When the assistant can't answer decides whether Contact support appears at all. Let AI decide shows it on Home and when the assistant is unsure; Never offer contact removes it.

Live chat handoff opens Crisp, Intercom, Help Scout, Zendesk, Freshdesk, tawk.to, Chatwoot, Drift or HubSpot when a reader asks for a person. Keep that chat's snippet on your site; Buuk only calls its browser API. If it hasn't loaded, the reader gets the Buuk form instead.

Hide the chat launcher until handoff stops two bubbles competing for the same corner. HubSpot can't be hidden this way.

With no live chat selected, an optional webhook receives each escalated question with the page, the articles opened, recent searches and a chat summary. A signing secret lets your endpoint verify the request.

## Saving

This page autosaves. The studio does not: it has an explicit Save changes button so a half-finished look never reaches readers.

Related: Widget studio; Embed the help widget; Hand off to live chat.