Appearance
Set the widget's brand, colours, position and size for every site or for one page.
Settings → Branding applies everywhere. A page can change its own copy with the appearance
and layout options.
Branding
Branding has four tabs, each with a live preview:
- Brand: the brand name, logo (PNG, JPG or WebP, up to 1 MB), brand colour (with presets and gradients), button colour, and whether to show "Powered by Helpwren".
- Widget: the launcher's position (bottom right or bottom left), its icon (a chat bubble, the wren in a bubble, or your logo), its space from the side and the bottom (0 to 120 pixels), the greeting and the line under it, a welcome message shown beside the launcher, and up to five quick replies of up to 60 characters each.
- Chat page: the title, the line under it, and the background (brand colour, plain or a
picture) of
/chat. - Help center: the same for
/help, with its links and search settings. See Search engines.
The chat follows the visitor's light or dark setting.
Change it for one page
Helpwren.init({
appearance: {
position: "left",
offsetX: 24,
offsetY: 96,
accent: "#1d4ed8",
accentTo: "#7c3aed",
accentInk: "#ffffff",
launcher: "wren",
},
layout: { width: 440, height: 720, zIndex: 1000 },
});appearance | What it does |
|---|---|
position | right or left |
offsetX | Pixels from the side, 0 to 120 |
offsetY | Pixels from the bottom, 0 to 120 |
accent | The launcher's colour, as six-digit hex such as #1d4ed8 |
accentTo | A second colour the launcher fades to |
accentInk | The colour of the icon on the launcher. Default #ffffff |
launcher | chat (a chat bubble), wren (the wren in a bubble) or logo (your logo, when set) |
A new accent brings its own accentTo and accentInk, or none, so a colour from Branding
never mixes with one from the page.
layout | What it does |
|---|---|
width | The floating panel's width in pixels, 320 to 640. Default 400 |
height | The floating panel's height in pixels, 420 to 900. Default 680 |
zIndex | The widget's z-index, for a page with layers of its own |
Change it after init
Helpwren.update changes appearance or layout later, for example when your site switches
theme:
Helpwren.update({ appearance: { accent: dark ? "#7fb59a" : "#3d6b57" } });The welcome message beside the launcher can be turned off for a page with welcome: false.