The chat widget is a small piece of code that adds your AI agent to your website. It takes about 2 minutes to install and works on any website — WordPress, Wix, Squarespace, Shopify, custom HTML, and more.
Step 1 — Get your embed code
From your ChatForge dashboard, go to your agent and click "Get Widget Code". You'll see a short snippet of JavaScript that looks like this:
<!-- ChatForge Widget --> <script src="https://chatforge.pro/widget.js" data-agent-id="your_unique_agent_id"> </script>
Click "Copy Code" to copy it to your clipboard.
Installing on WordPress
The easiest method uses the free "Insert Headers and Footers" plugin:
1
Install the plugin
In your WordPress admin, go to Plugins → Add New, search "Insert Headers and Footers" (by WPCode), and install + activate it.
2
Open the plugin settings
Go to Settings → Insert Headers and Footers in your WordPress admin sidebar.
3
Paste into the "Footer" section
Paste your ChatForge embed code into the "Scripts in Footer" text box.
4
Save and visit your site
Click Save. Open your website in a new browser tab — you should see the chat bubble in the bottom corner.
Installing on other platforms
| Platform | Where to paste the code |
|---|---|
| Shopify | Online Store → Themes → Edit code → theme.liquid → before </body> |
| Wix | Settings → Custom Code → Add Code → Body — End of tag |
| Squarespace | Settings → Advanced → Code Injection → Footer |
| Webflow | Project Settings → Custom Code → Footer Code |
| HTML site | Paste directly before </body> in every page you want it |
| Framer | Project Settings → General → Custom Code → End of <body> |
Customising the widget appearance
In the ChatForge dashboard, under your agent's "Widget Settings" tab, you can customise:
- Position — bottom right (default), bottom left, or custom
- Colour — match your brand colours
- Widget icon — chat bubble, robot icon, or custom image
- Launch delay — how many seconds before the widget appears
- Auto-open — whether the chat window opens automatically
- Mobile visibility — show or hide on mobile devices
Conversion tip
Enable "auto-open on exit intent" — the widget pops open when a visitor moves their mouse toward the browser close button. This alone can recover 10–20% of visitors who were about to leave.
Verify it's working
After installing, open your website in an incognito/private browser window. You should see the chat bubble. Click it and send a test message. If it responds correctly, you're live!
Don't see the widget?
Clear your browser cache and reload. If it still doesn't appear, double-check that the code is inside the <body> tag (not the <head>), and that your agent ID is correct. See our Troubleshooting section for more help.