1. AI Agent Installation & Integration
AI Agent Customer Support Docs
  • Default module
    • Product
      • Changelog
      • Agent Widget JavaScript SDK
      • Chat Widget Custom CSS Classes
    • AI Agents
      • Create AI Agent
      • Edit AI Agent
      • Delete Agent
    • Leads
      • Lead Settings
      • Lead Report
    • AI Agent Installation & Integration
      • Overview
      • Custom Website
      • WordPress
      • Link WhatsApp with AI Agent
      • Setup New WhatsApp Account
      • Google Tag Manager
      • Shopify
      • Squarespace
      • Wix
      • Webflow
      • Bubble
      • PrestaShop
      • GoDaddy
      • Function Tool Call
    • Billing & Pricing
    • Partner
      • Partner Management
    • Roadmap
      • Upcoming Features
    • Intelligence Settings
      • Intelligence Settings
    • Advance Settings
      • Overview
      • Header & Labels
      • Widget Tabs
      • Lead Capture Form
      • Quick Questions
      • Custom CSS and JS
      • Branding & Tracking
      • Behaviour Settings
      • Consent & Overlay
    • Partner Dashboard
      • How to Create White-Label
      • License Management
    • Message Credits
      • Message Credits
  1. AI Agent Installation & Integration

Squarespace

Use this guide to install the AI Agent widget on Squarespace.
Copy the Embed Code from your portal as described in Installation Overview.
Two embed methods are supported:
1.
Script-based loader (recommended): Adds an AI Agent bubble. The chat opens in an iframe popover when the visitor clicks the bubble.
2.
Iframe-based embed: Loads the AI Agent directly as an iframe appended to the page body (best for a dedicated page).

Best placement#

Script-based loader: Use Code Injection and add the code site-wide in the Footer area.
Iframe-based embed: Add only on a specific page (Code Block) where you want a direct embedded chat experience.
Important:
The embed code appends to document.body, so placing it in the Footer is safest.

Script-based loader (AI Agent Bubble)#

1.
Open Squarespace Admin.
2.
Go to Settings → Advanced → Code Injection.
3.
Paste the Script-based loader code into the Footer field (site-wide).
4.
Save changes.
5.
Publish (if required by your Squarespace setup).

Iframe-based embed (Direct AI Agent Chat)#

This method appends the iframe to the page body and is best used on a dedicated page.
1.
Open the page where you want the embedded AI Agent.
2.
Add a Code Block.
3.
Paste the Iframe-based embed code.
4.
Save and publish.
Notes:
To control size, adjust iframe.style.width and iframe.style.height in the code (example: 600px, 80vh, 100vh).
Some Squarespace blocks or templates can restrict scripts. If the Code Block does not run the script, use Code Injection for that page, or place the code in a footer injection area if your plan supports it.

Verify installation#

1.
Open your site in an incognito/private window.
2.
Confirm the bubble or embedded AI Agent loads.
3.
Send a test message and confirm replies.

Troubleshooting#

Widget not visible#

Confirm changes are saved and the site is published.
Hard refresh the page and clear cache.
Confirm the code was added to the Footer (recommended) and not stripped by the editor.
Check if your template or plan restricts third-party scripts.

Widget visible but not responding#

Check browser console for blocked requests (tracking blockers, CSP rules, network blocks).
Test with browser extensions disabled.

Duplicate widget#

Remove either the global Code Injection or the page Code Block if both are present.
Ensure the code is not added multiple times across different injection areas.
Modified at 2026-02-19 07:23:24
Previous
Shopify
Next
Wix
Built with