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​

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 not enough.

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. 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: