Site widget setup: greeting, position, color, quick actions
The site widget is the floating "Talk to us" bubble on a published site. Configure it from Site Settings → Widget (gear icon in the editor toolbar).
Settings:
• Enabled — the master switch. Off-by-default so brand-new sites don't ship a widget you didn't intend.
• Greeting — opening assistant message on first open. Falls back to "Hi! I can answer questions about {siteName} — or get a real human to follow up. What can I help with?"
• Button label — text on the floating bubble. Defaults to "Talk to us".
• Position — bottom-right or bottom-left of the page.
• Color — overrides the site primary color for the bubble + header band. Useful when your primary clashes with the page (e.g. light-on-light).
• Quick actions — up to 6 short chips shown under the greeting before the visitor types. Empty array hides chips. Defaults: "Book a time", "Talk to a human", "What do you offer?", "See your hours". See the article on widget actions for handoff / donate flow details.
Skipping in editor mode:
The widget is automatically suppressed in the editor preview iframe + the live-preview shell. Only real visits show it, so you never accidentally chat with your own page.
Capabilities (out of the box):
• AI chat grounded in your site's published content
• Inline booking against your booking profiles (slot picker → confirm)
• Lead capture for inquiries (auto-write to /website_submissions)
• Human handoff (intent-triggered + footer link)
• Inline donation via Stripe Embedded Checkout (when Stripe Connect is configured)
What it can't do (yet):
• Inline buy (e-commerce checkout) — the widget can direct visitors to product pages but doesn't run Stripe Checkout for retail purchases directly
• Inline restaurant reservation / lodging room booking — these route to their respective module pages
Conversation history:
The widget remembers conversations within a tab (sessionStorage). Closing and reopening the panel resumes mid-conversation. Closing the tab clears history.