Channelsbeginner

Enable the expandable chat window

Turn on 'Expandable chat window' in a widget's General settings to give visitors a header control that enlarges the chat window to about 480px wide and 90% of viewport height, clamped to their screen.

4 min read

Enable the expandable chat window

By default, a Web Chat widget opens at a fixed, compact size. Turning on Expandable chat window adds a control to the chat header that lets visitors enlarge the window for a roomier view, then shrink it back down.

What it does

When enabled, the widget header shows an expand button next to the other header controls. Clicking it:

  • Enlarges the window to about 480px wide and 90% of the viewport height, leaving a small gap at the top.
  • Clicking again (the shrink control) returns the window to its default size.

The enlarged size is always clamped to the visitor’s actual screen — it can never grow past the edges of the viewport, no matter how the site is laid out. On small or mobile viewports, where the widget is already shown full-screen, the expand button is hidden entirely since there’s nothing to expand into.

Turn it on

  1. Go to Settings → Web Chat.
  2. Open the widget you want to change.
  3. On the General tab, find Expandable chat window.
  4. Toggle the switch on.
  5. Save your changes.

There’s nothing else to configure — the size, clamping, and mobile behavior are all handled automatically. No custom CSS or embed snippet changes are needed.

Things to know

  • Off by default. Every widget starts with this disabled. A tenant’s chat window won’t gain a new control unless you turn it on.
  • Per-widget. If you run multiple widgets, enable it separately on each one that should offer it.
  • Persists per browser. Once a visitor expands (or shrinks) the window, their choice is remembered for that browser and session, so the widget reopens at the size they left it in.
  • Never overflows the screen. The expanded size is capped against the visitor’s viewport, so it looks correct on smaller laptop screens and large monitors alike.
  • Hidden on small screens. On mobile-sized viewports the widget already fills the screen, so the expand control doesn’t appear — there’s no larger size to expand to.

See also

Tags

How ToConfiguration