Widget implementation

Use these steps when adding the widget to a theme, tag manager, or custom storefront.

Basic installation steps

1. Copy your widget snippet from Settings → Integration
2. Paste it right before </body> in the global page template
3. Set the data-store-id and data-language attributes for the store
4. Deploy the change and clear any theme, CDN, or browser cache
5. Check one product page and one non-product page on desktop and mobile

Optional parameters

Add optional attributes only when you need to override the account defaults:

• data-theme for the widget color preset
• data-position for bottom-right or bottom-left placement
• data-primary-language to force an initial default
• data-auto-open for guided flows where the chat should open by itself

Common mistakes

• An old CDN or theme cache still serves the previous script
• The script is installed twice, once globally and once on a page template
• The widget is rendered inside a container hidden by default
• The store URL is missing https://, which can block secure resources

If the widget still fails, contact support with the affected page URL, your store ID, and any browser console errors.