# Install your widget

Publish your assistant, configure allowed origins, and add the website script.

Canonical: https://webotx.com/docs/install-widget
Updated: 2026-10-15

## Publish the assistant first

In Install widget, approve the business overview and at least one page, then select Publish widget. Owners and Admins can publish. An unpublished assistant cannot serve the public widget.

![Install widget screen with publishing requirements and the Allowed widget origins field](https://webotx.com/docs/screenshots/example-install-widget.jpg)

Install widget brings together publishing checks and allowed origins. In this example, publishing is still unavailable because the overview needs approval.

## Allow each exact website origin

An origin is the protocol, hostname, and port, without a page path. Enter one origin per line in Allowed widget origins and save. For example, https://example.com and https://www.example.com are different origins and must be added separately if both serve your site.

Use the visitor-facing origin after redirects. HTTP and HTTPS differ, and a non-default port is part of the origin. You can save up to ten origins. For a local widget preview, also allow the WebotX website origin shown in the dashboard.

## Copy your generated script

Choose your platform in Install widget and copy the complete script. Add it once per page in your site-wide footer or shared layout, after the page body is available.

The example below shows the format. YOUR_WIDGET_KEY is a placeholder; use the real script from your own workspace. A localhost script is for local testing. A live website needs a publicly reachable HTTPS WebotX address.

```html
<script
  src="https://webotx.com/widget.js"
  data-webotx="YOUR_WIDGET_KEY"
  async>
</script>
```

## Use a site-wide script location

WebotX uses the same script across website platforms that permit custom JavaScript. The dashboard has installation instructions for custom websites, Shopify, WordPress, Squarespace, Wix, and Webflow.

Choose a site-wide placement so visitors can use the assistant across pages. Your website builder's plan and custom-code settings determine whether it permits the script. Check the platform guide linked in the dashboard for its current requirements.

## Check the published website



1. Save and publish your website changes. Clear its page cache if needed.
2. Open a public page and check that the chat launcher appears.
3. Ask a question supported by your approved knowledge and check the sources.
4. Choose Ask for a person and check the conversation in your dashboard.
5. If the widget fails, check publishing, exact allowed origins, and browser errors using the troubleshooting guide.