Widget design settings

The widget is white-labeled by default — shoppers see your store’s own voice, not “Cartfilo.” All of its design settings live under Widget in your admin navigation, with a live storefront preview alongside the form.

The Widget settings form next to its live storefront preview

Enabled

A single switch that turns the floating launcher on or off across your storefront. Turning it off hides the launcher everywhere without touching your theme’s app embed toggle.

Launcher position

Bottom right or Bottom left — where the launcher bubble sits on the page.

Size behavior

How the chat panel opens on desktop: Compact (a small floating window), Side Panel (docked to the right edge), or Full Screen.

Assistant name

The shopper-facing label shown in the chat header, next to the online status. Defaults to “Shop Assistant” — change it to match your brand’s tone. This is what your customers see; “Cartfilo” never appears to them unless you choose to use it here.

Primary color

A hex color (e.g. #111827) applied to the launcher and chat accents.

Greeting

The first message a shopper sees when they open the widget, up to 300 characters.

Chat icon

Shown on the launcher button and in the chat header. Upload a square PNG or SVG, ideally 128–512px per side — the launcher renders it at 56px, so anything smaller looks soft. A transparent background is recommended since the icon is masked into a circle; a non-square image gets cropped. Max size 300KB.

All changes here apply immediately on your storefront — no theme redeploy needed.

Brand aliases and FAQ

Two more shopper-facing content sources live under Settings rather than this page: teach the assistant your store’s own product nicknames in Brand aliases, and give it ready answers to common questions in FAQ answers.

Next: Brand aliases.