Skip to main content
The Widget configuration page (found under Channels > Chat in the sidebar) lets you create, style, and deploy chat widgets to your website.
You must configure chat before creating widgets. If chat is not configured, widgets will not function.

​
Creating a widget

If no widgets exist, you’ll see an empty state with a Create chat widget button. Click Create chat widget to open the creation modal:
​
Widget name
string
required
A name to identify this widget (e.g., “Main website”, “Support portal”).
​
Website URL
string
required
The URL where this widget will be deployed.
​
Variant
dropdown
required
Select which variant this widget connects to.
​
Environment
dropdown
required
Select the deployment environment: Sandbox, Pre-release, or Live.
You can create multiple widgets for different websites or variants, each with unique styling and configuration.

​
Widget editor

After creating a widget, use the editor to configure its appearance and behavior. The editor has three tabs: Styling, Content, and Embed. A live preview panel on the right shows your changes in real-time.

​
Header controls

  • Widget selector - Dropdown to switch between widgets
  • Settings icon - Access widget settings
  • Save and publish - Deploy changes to the selected environment

​
Styling tab

Customize the visual appearance of your widget.
​
Header text
string
The title shown in the widget header. Use your brand name or assistant name.Example: “PolyAI Assistant”
​
Header image
file
Upload a logo or image for the widget header.

​
Agent

​
Agent name
string
The name displayed for the agent in chat messages.Example: “Support Assistant”
​
Agent image
file
Upload an avatar image for the agent.

​
Color

​
Primary color
string
Sets the color for the header and action elements. Enter a hex code or use the color picker.Example: #161617
Check color contrast to ensure text remains readable against your chosen color.

​
Content tab

Configure disclaimers and consent requirements.

​
Disclaimers

​
Enable disclaimers
boolean
Toggle to show a disclaimer message before users can start chatting.
​
Disclaimer message
string
The message shown to users before they begin chatting.Example: “This is an AI-powered system. All chats are recorded for quality and training purposes.”
​
Enable consent button
boolean
When enabled, users must click “I consent and start chat” before the conversation begins.
​
Reset to default
button
Restore the disclaimer message to its default text.

​
Company policies

​
Enable company policies
boolean
Toggle to show links to your Privacy Policy and Terms & Conditions below the consent button.
When enabled, add your policy URLs:
​
Privacy policy URL
string
Example: https://example.com/privacy-policy
​
Terms & conditions URL
string
Example: https://example.com/terms-conditions

​
Embed tab

Deploy your widget to production.

​
Instructions

The embed tab provides step-by-step instructions for adding the widget to your website.

​
Widget status

Each widget displays:
  • Widget name - The name you assigned
  • Status badge - Shows “Live” when published, or the current state
  • Script tag - The code to copy and embed on your site
  • Last published - Timestamp of the most recent deployment

​
Deploying the widget

  1. Review the widget status and ensure it shows the correct environment.
  2. Copy the script tag from the code block.
  3. Paste the script before the closing </body> tag on your website.
<script src="https://widget.polyai.app/widget.js?id=YOUR_WIDGET_ID"></script>
If you update widget settings, click Save and publish for changes to take effect. The script tag itself does not need to be replaced unless you create a new widget.

​
Testing

​
Live preview

The preview panel on the right side of the editor shows:
  • “You’re previewing [widget name]” banner
  • Test widget link to interact with the widget
  • Real-time updates as you adjust settings
Click Test widget to open a functional preview and verify greetings, styling, and consent flow.

​
Managing multiple widgets

You can create multiple widgets for different use cases:
  • Different websites or domains
  • Different variants for location-specific experiences
  • Different environments for testing vs. production
Use the widget selector dropdown in the header to switch between widgets.