Integrations

Website Integration

Embed your AI chatbot on any website with a single line of code.

8 min readUpdated January 2026

Key Takeaways

  • Script tag embed is the easiest—just one line of code
  • Iframe embed gives you more layout control
  • Direct links and QR codes work for offline/print materials
  • Customize colors, position, and welcome messages
  • Use domain restrictions to control where your bot appears

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.

Easiest setupNon-intrusive

Iframe Embed

Embed the chat directly into a page section. Best for help centers and dedicated support pages.

Inline placementCustom sizing

Direct Link

A standalone page URL you can share anywhere. Best for email, social media, or QR codes.

No code requiredQR code support

Finding Your Embed Code

  1. Go to your chatbot's dashboard
  2. Click Deployment in the sidebar
  3. Choose your deployment method
  4. 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

  1. Go to Appearance → Theme Editor
  2. Select footer.php
  3. Paste the script before </body>
  4. Save changes

Or use a plugin like "Insert Headers and Footers" for easier management.

Shopify

  1. Go to Online Store → Themes
  2. Click Actions → Edit code
  3. Open theme.liquid
  4. Paste the script before </body>
  5. Save

Wix

  1. Go to Settings → Custom Code
  2. Click "Add Custom Code"
  3. Paste the script
  4. Set placement to "Body - end"
  5. 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

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

SettingWhat It ChangesDefault
Window BackgroundMain chat area background#F0F8FF
Header ColorTop header bar#004790
User MessageUser's chat bubble#004790
Bot MessageAI's chat bubble#FFFFFF
Send ButtonSend 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:

1 day7 days30 days90 daysNever

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

  1. Go to your chatbot's Deployment page
  2. Toggle "Enable Deployment Security"
  3. Configure your desired security options
  4. 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 iframe or div broadly
  • 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!

Next Steps

logo

Empowering your growth, one chatbot at a time

Information

About UsFAQ

© Copyright 2026 - Chat.co