Widget Configuration

All widget configuration lives under Settings → Widget inside your project. Changes propagate to the embedded script within about a minute (script cache TTL).

Position

Where the floating button sits on the page.

Value Location
bottom-right Default. Most common placement.
bottom-left Opposite corner if your site already has something bottom-right.
top-right Top of the page.
top-left Top of the page, opposite corner.

Theme

Built-in color themes: indigo, sky, slate. These set a sensible default palette for the banner, messages, and buttons. You can override specific colors individually — the theme is just a starting point.

Custom colors

You can override any of the following individually:

  • Banner color — header bar background
  • Title color — header text
  • Send button color — the send-message button in the input
  • Start-chat button color — the CTA before the visitor enters the form
  • Form submit button color — submit on the pre-chat form
  • Rating submit button color — submit on the post-chat rating
  • Rating stars color — highlighted stars
  • Client message background — visitor bubbles
  • AI message background — assistant bubbles
  • System message background — system notices inside the chat

Icon

The floating button icon:

  • iconType: 'emoji' — render an emoji, e.g. 💬 (default)
  • iconType: 'image' — render an image from iconUrl

Sizes:

  • emojiSize — pixel size of the emoji, default 32
  • iconSize — pixel size of the button itself, default 56
  • iconColor — button background color

Trigger

  • floating — the default floating button in the chosen corner
  • custom — no floating button; you open the widget yourself via window.aiSupportWidget.open(). See Widget JS API.

Form fields

Before a visitor can chat, you can require some contact info:

  • requireName — ask for a name
  • requireEmail — ask for an email address
  • requirePhone — ask for a phone number

These feed Hot Leads and the Clients tab inside your project.

Anti-spam

Optionally enable Cloudflare Turnstile or Google reCAPTCHA on the pre-chat form. Configure the site key under Settings → Widget → Security. See Security.

Language

The widget supports English and Portuguese. You can:

  • Set a project default language
  • Pin the language via the lang URL parameter on the script tag (see Widget Embed)
  • Switch it at runtime via window.aiSupportWidget.setLanguage('EN' | 'PT') (see Widget JS API)

See Languages for full details.

Widget Configuration — Docs — Aira