BigCommerce chatbot embed
Use BigCommerce Script Manager or the storefront theme to load the widget across the store.
BigCommerce
Before you start
Best for
Stores that need product guidance, shipping answers, returns help, catalog support, and pre sale questions.
Install location
Use Script Manager for the storefront channel, all pages scope, and footer location.
Install
Install steps
- 1Copy the widget snippetOpen the chatbot Embed page and copy the generated script.
- 2Open Script ManagerIn BigCommerce, open the storefront Script Manager for the channel that serves the public store.
- 3Create a footer scriptCreate a script for all pages, choose footer placement, and paste the complete script.
- 4Save and testSave the script, open the storefront, and test home, category, product, and cart pages.
Access
Domains
Add the public storefront domain.
Add preview or staging domains only while testing.
For headless stores, add the headless storefront hostname rather than the BigCommerce control panel host.
Verify
Verify
Stencil themes need the footer scripts output in the theme for footer scripts to render.
Checkout availability can vary by store configuration. Verify where the widget is expected to appear.
If a script manager policy blocks external scripts, use the approved store theme workflow.
Troubleshoot
BigCommerce troubleshooting
If the launcher does not appear, confirm the chatbot is published, the plan and credits are active, and the exact live hostname is allowed.
If the widget loads in preview but not production, check whether the builder preview URL and the live custom domain are different hostnames.
If the page has a content security policy, allow the OrhanAI app URL and widget requests before retesting.
If the launcher appears twice, remove duplicate snippets from theme files, site settings, and tag managers.
If mobile layout feels crowded, adjust widget position and test the most important conversion pages first.
If these checks pass and the widget still does not load, compare the installed snippet with the current Embed page and review widget setup.