Skip to Content
Docs

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

index.html
Helpwren.init({
  appearance: {
    position: "left",
    offsetX: 24,
    offsetY: 96,
    accent: "#1d4ed8",
    accentTo: "#7c3aed",
    accentInk: "#ffffff",
    launcher: "wren",
  },
  layout: { width: 440, height: 720, zIndex: 1000 },
});
appearanceWhat it does
positionright or left
offsetXPixels from the side, 0 to 120
offsetYPixels from the bottom, 0 to 120
accentThe launcher's colour, as six-digit hex such as #1d4ed8
accentToA second colour the launcher fades to
accentInkThe colour of the icon on the launcher. Default #ffffff
launcherchat (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.

layoutWhat it does
widthThe floating panel's width in pixels, 320 to 640. Default 400
heightThe floating panel's height in pixels, 420 to 900. Default 680
zIndexThe 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:

app.js
Helpwren.update({ appearance: { accent: dark ? "#7fb59a" : "#3d6b57" } });

The welcome message beside the launcher can be turned off for a page with welcome: false.