Skip to content

Dark Mode

Many websites let visitors switch between light and dark themes, so a chat widget that matches looks far more at home. The ChannelX live chat widget supports dark mode, and turning it on takes a single setting.

Enabling dark mode

Add the darkMode parameter to your chatwootSettings:

window.chatwootSettings = {
  // ...other settings
  darkMode: "auto",
};

The darkMode parameter accepts two values:

Value Behavior
light Light mode only. This is the default.
auto Follows the visitor's operating system preference, switching to dark when their OS is in dark mode.

Note

A forced dark-only value isn't available — use auto to follow the visitor's system setting, or light to keep the widget light at all times.

Common questions

Why doesn't the widget switch to dark even with darkMode: "auto"? auto follows the operating system theme. If the visitor's OS is set to light mode, the widget stays light. Switch the OS to dark to see the change.

Can I force the widget to always be dark? Not currently. The supported values are light and auto.