Skip to content

Add it to your own site

Wix, WordPress, Shopify, Squarespace or plain HTML: one line, and your agent answers on the site you already have

The one line

Paste this once, anywhere in your site's HTML. A round button appears in the corner and opens your agent, the same one that answers on your published site.

<script src="https://branderux.com/widget/v1.js" data-key="bux_pk_..." data-preload="eager" async></script>

The key is a project API key from Projects → API Keys, and your site's address must be on that key's list of allowed origins. Ask the Builder for the line and it fills everything in, including your brand color and icon:

<script src="https://branderux.com/widget/v1.js"
        data-key="bux_pk_..."
        data-color="#c9a24b"
        data-icon="https://your-business.branderux.app/brand-icon"
        data-preload="eager"
        async></script>

Where to paste it

  • Wix: Settings → Custom Code → add the line to the body end, on all pages. Wix needs a Premium plan with a connected domain for custom code.
  • WordPress: your theme's custom code, a headers-and-footers plugin, or a Custom HTML block on the page.
  • Shopify: the theme editor, in theme.liquid just before </body>.
  • Anything else: just before </body>.

Your own button

Any element you mark opens the chat: a menu item, a button in your layout, a link. Add data-launcher="none" to the script line to hide the round button when you use your own.

<a href="#brander-chat">Ask our assistant</a>
<button data-brander-open>Chat with us</button>
<button data-brander-open="anchor">Ask about this</button>
  • A link to #brander-chat works everywhere a menu item can carry a link, Wix included.
  • data-brander-open on any element, or the class brander-open for page builders that take a class but no attribute.
  • data-brander-open="anchor" opens the chat above that element instead of in the corner.

What visitors get

The full agent: answers from your real data, branded screens, the actions you enabled, and a conversation that follows the visitor from page to page on your site. Visitors are not signed in inside the widget; sign-in, when your site requires it, stays on your published address.

Keep data-preload="eager" on the line: with the home page the Builder designed, loading the chat with the page costs nothing and it opens instantly. Remove it only if your project has no designed home page; the chat then loads the moment a visitor reaches for the button.

If it says the site isn't allowed

The button opens but shows "This site isn't allowed to use this key yet". Add your site's exact address, such as https://www.example.com, to the key's allowed origins in Projects → API Keys, or ask the Builder to do it. The address must match what visitors see in the browser, with or without www.