Checklist
Before you start
- Publish the AI Agent only after the playground answers, fallback, lead capture, and widget design are approved.
- Copy the final snippet from the AI Agent Embed page, not from a screenshot or old ticket.
- Add every live hostname that will load the widget to the AI Agent domain settings.
- Install the snippet once per page, ideally in a footer or body end code field.
- Verify from a normal visitor window after publishing the website changes.
Platforms
Platform pages
WordPress
Install the OrhanAI widget on a self hosted WordPress site or a WordPress.com site that supports custom JavaScript.
Open guideWebflow
Add the widget script to Webflow site settings for every page or to page settings for a single page.
Open guideShopify
Install the AI Agent launcher on a Shopify storefront by adding the script to the active theme.
Open guideWix
Use Wix custom code settings to load the widget on all published site pages.
Open guideSquarespace
Install the widget through Squarespace Code Injection so it loads before the closing body tag.
Open guideFramer
Add the widget script in Framer custom code settings and run it on the pages where visitors need chat.
Open guideGoogle Tag Manager
Deploy the widget through a Google Tag Manager Custom HTML tag when GTM is already installed on the website.
Open guideBigCommerce
Use BigCommerce Script Manager or the storefront theme to load the widget across the store.
Open guideBubble
Add the widget to a Bubble app through custom header or body settings, then deploy the app.
Open guideCarrd
Use a Carrd Embed element in hidden body end mode to load the widget on a published page.
Open guideCustom HTML
Install the widget on custom HTML, server rendered, React, Next.js, Astro, Laravel, Rails, Drupal, Joomla, Duda, or similar sites.
Open guideVerify
Verify install
- 1Open the live pageUse the public URL, not only the builder preview. The widget should show the launcher in the configured corner.
- 2Check browser consoleA blocked config request usually means the AI Agent is unpublished, paused, or missing the live domain.
- 3Send a real questionConfirm the answer uses trained knowledge, stores the conversation, and shows image upload only when expected.
- 4Test mobileOpen the same URL on a small screen and confirm the launcher, panel, and composer are usable.
Troubleshoot
Common embed blockers
- If the launcher does not appear, confirm the AI Agent is published 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.
WordPress AI Agent embed
Install the OrhanAI widget on a self hosted WordPress site or a WordPress.com site that supports custom JavaScript.