HelpShelf

Customizing the widget

Match the widget to your brand — colours, position, logos, and text.

All widget styling lives on the Widget page in your dashboard, with a live preview beside the controls. Changes are fetched by the widget at runtime, so they reach your site without a redeploy.

Colour

Set a primary and secondary colour. Primary drives the launcher button, headings, and interactive elements; secondary is used for accents.

If HelpShelf scanned your site during setup, the colours it detected from your brand are offered as suggestions — usually a good starting point.

Layout

Position puts the launcher in the bottom-left or bottom-right corner. Bottom-right is the convention; use bottom-left if you already have something in the right corner, like a cookie banner or a cart button.

Text

Set the widget title and the greeting visitors see when they open the panel.

A specific greeting outperforms a generic one. "Ask us anything about shipping, returns, or your order" gives visitors a starting point; "Hi there! 👋" gives them nothing.

Logos

Two separate images:

  • Widget logo — shown in the panel header
  • Launcher logo — the icon on the button itself

Custom logos are a paid feature, bundled with branding removal. On the Free plan both show the HelpShelf mark. See Plans and credits.

Branding

Paid plans can hide the "Powered by HelpShelf" line in the panel footer. The Free plan always shows it.

Preview before you ship

The live preview on the Widget page renders the real widget with your real config, so what you see is what visitors get. Test on a narrow window too — the panel adapts to mobile widths, and long titles behave differently there.

Was this article helpful?

Still puzzling over something?

The agent has read this article — and everything around it. Ask a follow-up and it answers in seconds.