Once you've built and tested your chatbot, it's time to deploy it. Chat.co offers multiple ways to add your chatbot to any website—from a simple script tag to fully customized iframe embeds. This guide covers all deployment options and customization settings.
1. Deployment Methods
Chat.co provides three ways to deploy your chatbot. Choose based on your needs:
Script Tag (Recommended)
A floating chat bubble that appears on every page. Best for most websites.
Iframe Embed
Embed the chat directly into a page section. Best for help centers and dedicated support pages.
Direct Link
A standalone page URL you can share anywhere. Best for email, social media, or QR codes.
Finding Your Embed Code
- Go to your chatbot's dashboard
- Click
Deploymentin the sidebar - Choose your deployment method
- Copy the code or link
2. Script Tag Embed
The script tag is the easiest way to add a chat widget to your website. It creates a floating bubble that expands into a full chat window when clicked.
Basic Installation
Add this code just before the closing </body> tag on any page:
<script defer src="https://chat.co/api/embed" data-bot-id="YOUR_BOT_ID" ></script>
Replace YOUR_BOT_ID with your actual chatbot ID (found on the Deployment page).
How It Works
- Floating bubble — A circular button appears in the corner of the page
- Hover preview — Shows "Ask AI" text when users hover
- Click to open — Expands into a full chat window
- Mobile responsive — Goes full-screen on mobile devices
Platform-Specific Instructions
WordPress
- Go to Appearance → Theme Editor
- Select
footer.php - Paste the script before
</body> - Save changes
Or use a plugin like "Insert Headers and Footers" for easier management.
Shopify
- Go to Online Store → Themes
- Click Actions → Edit code
- Open
theme.liquid - Paste the script before
</body> - Save
Wix
- Go to Settings → Custom Code
- Click "Add Custom Code"
- Paste the script
- Set placement to "Body - end"
- Apply to "All pages"
React / Next.js
// In your _app.tsx or layout component
import Script from 'next/script';
export default function App({ Component, pageProps }) {
return (
<>
<Component {...pageProps} />
<Script
src="https://chat.co/api/embed"
data-bot-id="YOUR_BOT_ID"
strategy="lazyOnload"
/>
</>
);
}Tip: The defer attribute ensures the script loads after your page content, preventing any performance impact on page load times.
3. Iframe Embed
Use an iframe when you want to embed the chat directly into a page section rather than as a floating widget.
Basic Iframe Code
<iframe src="https://chat.co/embed/YOUR_BOT_ID" style="width: 400px; height: 600px; border: none;" title="Chat Assistant" ></iframe>
Responsive Iframe
Make the iframe adapt to its container:
<div style="width: 100%; max-width: 500px; height: 700px;">
<iframe
src="https://chat.co/embed/YOUR_BOT_ID"
style="width: 100%; height: 100%; border: none; border-radius: 12px;"
title="Chat Assistant"
></iframe>
</div>When to Use Iframe
Good for
- Dedicated help center pages
- Contact pages
- Knowledge base sections
- Support portals
Not ideal for
- Site-wide availability
- E-commerce product pages
- Mobile-first sites
- Pages with limited space
4. Direct Link & QR Code
Sometimes you don't need to embed anything—just share a link to your chatbot's standalone page.
Your Chatbot Link
https://chat.co/embed/YOUR_BOT_IDUse Cases
Email signatures
Add "Chat with our AI assistant" link to employee email signatures.
Messaging apps
Share via WhatsApp, Slack, or Teams for quick customer access.
Print materials
Generate a QR code for brochures, business cards, or trade show booths.
Social media bios
Add to your company's social profiles for instant support access.
QR Code Generation
Chat.co automatically generates a QR code for your chatbot link. Find it on the Deployment page and download it in SVG format for print-ready quality.
Tip: QR codes work great at trade shows and events. Print them on table signs or badges so visitors can instantly access your AI assistant.
5. Customization Options
Make your chatbot match your brand with extensive appearance customization. All settings are configured in your chatbot's Appearance tab.
Color Customization
| Setting | What It Changes | Default |
|---|---|---|
| Window Background | Main chat area background | #F0F8FF |
| Header Color | Top header bar | #004790 |
| User Message | User's chat bubble | #004790 |
| Bot Message | AI's chat bubble | #FFFFFF |
| Send Button | Send message button | #004790 |
Widget Position
Choose where the chat bubble appears:
- Right (default) — Bottom-right corner
- Left — Bottom-left corner
Branding Options
Custom Logo
Upload your company logo or avatar to display in the chat header and bubble.
Hide Chat.co Branding
Remove "Powered by Chat.co" for a fully white-labeled experience (Pro plan and above).
Custom Branding Text
Replace the default branding with your own text (e.g., "Powered by Your Company").
Content Customization
- Chat Title — The name shown in the header
- Welcome Message — First message users see when opening the chat
- Placeholder Text — Text shown in the empty input field
- Suggested Questions — Quick-reply buttons for common questions
Advanced Features
Lead Form
Collect name, email, phone before or during chat. Configurable required fields.
Voice Input/Output
Enable voice chat with multiple voice options via AWS Polly.
Citations
Show or hide source citations in AI responses.
Document Upload
Allow users to upload documents during chat for analysis.
6. Deployment Security
Protect your chatbot with security settings to control who can access it and from where.
Security Options
Password Protection
Require a password to access your chatbot. Passwords are securely hashed with bcrypt. Includes rate limiting (5 attempts per minute) to prevent brute force attacks.
Link Expiration
Set your deployment link to expire after a specific period:
IP Whitelist
Only allow access from specific IP addresses. Perfect for internal tools or office-only access.
IP Blacklist
Block access from specific IP addresses. Useful for stopping abuse or unwanted traffic.
Enabling Security
- Go to your chatbot's Deployment page
- Toggle "Enable Deployment Security"
- Configure your desired security options
- Save changes
Note: Security settings apply to all deployment methods (script, iframe, and direct link). When password protection is enabled, users must enter the password before they can use the chatbot.
7. Troubleshooting
Common issues and how to fix them.
Widget doesn't appear
- Check that the script is placed before
</body> - Verify the bot ID is correct
- Make sure your chatbot is set to "Active"
- Check browser console for JavaScript errors
- Disable ad blockers (some block chat widgets)
Widget appears but chat doesn't load
- Check if deployment security is blocking access
- Verify the chatbot has active sources/training data
- Ensure you haven't exceeded message limits
- Try clearing browser cache and cookies
Iframe shows blank or error
- Check if your site uses HTTPS (required for embedding)
- Verify the iframe src URL is correct
- Some sites block iframes—check Content Security Policy headers
Styling conflicts
- The widget uses isolated styles, but some global CSS can interfere
- Check for CSS rules targeting
iframeordivbroadly - Use browser dev tools to inspect conflicting styles
Still having issues?
Contact our support team at support@chat.co with your chatbot ID and a description of the problem. We're happy to help!
