Appearance

• Theme – Default (rounded card), Minimal (flat, neutral header), Bubble (softer, larger radius) or Sidebar (full-height panel docked to the edge).

• Accent colour – used for the header, launcher and visitor bubbles. Text automatically switches between black and white for contrast.

• Colour mode – light, dark, or follow the visitor's system setting.

• Position – bottom right or bottom left.

• Launcher – Bubble (icon only), Pill (icon and label such as "Chat with us") or Hidden. With a hidden launcher, open the widget from your own button with window.Svellyo("open").

• Logo and agent avatar – upload PNG, JPG, SVG or WebP up to 2 MB. The logo shows in the header on the home view; the avatar shows next to AI and team replies when a teammate has no photo.

Messages

• Team name – the header title, for example "Acme Support".

• Welcome title and message – the greeting on the home view.

• Reply-time text – shown under the team name while you are online, for example "We usually reply within a few minutes".

• Away message – shown outside business hours or when nobody is online and the AI is off.

• Suggested questions – up to a handful of one-tap prompts on the home view. Good suggested questions are the ones your knowledge base answers best.

Behaviour

Pre-chat form

Ask for name, email, phone or company before the first message, each optional or required. Skip it when you already identify signed-in users; the fields are only shown to anonymous visitors.

Proactive triggers

• Auto-open after N seconds – opens the widget once per visitor after a delay.

• Auto-open on paths – opens the widget once on matching pages, for example /pricing or /docs/*.

Both fire only once per visitor, so returning visitors are not nagged.

Hide on these pages

Paths where the widget should not appear at all, one per line. /admin/* hides everything under /admin, * matches a single segment, ** matches any depth. This applies to every install without a code change. Developers can also pass excludePathsin code; see the installation guide.

Features

• File attachments – let visitors send images and files up to 10 MB.

• Notification sound – a chime in the widget when a reply arrives while the panel is closed.

• Satisfaction rating – ask for a 1 to 5 rating when a chat is closed. Ratings appear in Analytics.

• What's new tab – show your announcements inside the widget.

Language

Set the widget language under Appearance. The interface strings (buttons, placeholders, status text) follow it. Independently, the AI can reply in the visitor's own language; see the AI settings.

Branding

"Powered by Svellyo" appears at the bottom of the panel on the Free plan and is removed automatically on Pro and Scale.

Business hours

Under Settings → Hours, set the days and times your team is available and the timezone. The widget shows Online during those hours and your away message outside them. You can also choose to route chats straight to the AI or to the message form when you are offline.

Testing changes safely

The preview inside Settings is a sandbox with sample messages. To test on a real page without affecting visitors, add http://localhost:3000 (or wherever you develop) to Allowed origins and load the widget there.