FlagbellHelp

Add the chat widget to your site

One script tag puts the live chat on every page of your site.

Every brand in Flagbell has its own widget key (fbw_…). Put this tag on your pages, just before </body>:

<script src="https://app.flagbell.com/widget/v1/widget.js" data-key="fbw_…" async></script>

A chat button appears in the bottom right corner. A dot on it shows whether someone of your team is online.

Options on the tag

AttributeWhat it does
data-keyYour brand's widget key (required).
data-colorThe accent colour, as a hex colour. Default: #1F3BFF.
data-langen or nl. Without it the widget follows the page's <html lang>, then your brand's language.
data-user-tokenWho is signed in on your site. See Chat with signed-in visitors.
data-mailboxpartner on pages for partners. See Chat on partner pages.

Which sites can use it

The widget only works on the sites (origins) listed for your brand, and always on your brand's help centre. Chats from any other site are refused.

Content Security Policy

If your site sends a CSP, allow Flagbell for the script and the live connection:

script-src 'self' https://app.flagbell.com;
connect-src 'self' https://app.flagbell.com wss://app.flagbell.com;

The widget sets no cookies. It draws itself in its own Shadow DOM, so your styles don't reach it and its styles don't reach your page.

Updated 23 October 2026