Skip to main content

Widget Experience

Use the widget experience settings to control how the chat feels on the live site, beyond simple branding.

Theme presets​

Hunch supports:

  • custom
  • ocean
  • sunset
  • forest
  • midnight
  • rose

Presets apply coordinated primary and secondary colors plus richer live treatment inside the widget.

Localization​

The widget can localize built-in interface copy such as:

  • launcher labels
  • empty states
  • offline messaging
  • helper text
  • voice and system prompts

Supported languages:

  • English (en)
  • French (fr)
  • Spanish (es)
  • German (de)
  • Brazilian Portuguese (pt-BR)

Greeting and identity​

You can control:

  • whether the greeting appears
  • whether assistant avatars are shown
  • the widget title
  • launcher icon behavior

Offline behavior​

The widget has explicit offline handling for when the visitor loses network connectivity.

It can:

  • show an offline banner
  • stop sending messages while disconnected
  • localize the offline warning
  • respect your handoff/offline capture configuration

If your handoff mode is configured for offline capture, you can also define the message shown when human support is unavailable.

Mobile behavior and accessibility​

The current widget includes:

  • stronger full-window behavior on mobile
  • focus management for the chat input when the widget is available for typing
  • keyboard-friendly controls
  • accessible dialog labeling
  • richer ARIA and screen-reader status messages around loading and connectivity states

Custom CSS and custom JavaScript​

Advanced teams can inject:

  • custom CSS
  • custom JavaScript

Use these only when the built-in controls are insufficient.

Typical safe uses:

  • small spacing or typography adjustments
  • site-specific event hooks
  • analytics hooks tied to widget lifecycle events

Typical unsafe uses:

  • overriding essential layout or pointer behavior
  • hiding required consent or safety UI
  • changing secure-field behavior

Structured responses​

The current widget can render rich result blocks inside the conversation, including:

  • cards
  • product cards
  • comparison tables
  • booking and result grids
  • forms
  • charts
  • action button groups

These elements can be clickable where appropriate, and plain raw URLs in assistant text are also linkified.

When to use dashboard config vs inline config​

Prefer dashboard-managed settings for:

  • team-managed websites
  • repeatable rollouts
  • preview before publish
  • environments where non-developers operate the site

Use inline embed initialization only when your application must control widget startup programmatically.

See also: