HomeAdd a widgetSquarespace
Add an AI chat widget to Squarespace
A chat agent that answers from your own content, floating in the corner of every page on Squarespace — with 200 conversations a month included on the $19 plan, and a person able to take over at any point.
Free plan, no card. Paid plans start at $19 a month.
Why do it this way on Squarespace
Use Code Injection’s Footer field rather than a Code Block. Two reasons, both concrete: a Code Block only loads on its own page, so the launcher would disappear as soon as a visitor navigated; and a block whose script draws nothing in place still occupies vertical space, leaving a visible gap in the layout — most obviously in Fluid Engine sections. Footer injection has neither problem, and it is on the same plan gate as the block anyway.
See it working
There is a live one on this page already. The chat button in the bottom corner is a Sorraia AI chat agent — ours, answering from this site’s own content — installed exactly the way the steps above describe. Open it and ask it something.
How to add an AI chat widget to Squarespace
A launcher that has to float over every page goes in Code Injection, not in a Code Block — a Code Block only exists on the page you put it on, and a block whose script renders nothing in place still leaves an empty gap in the layout.
The tiers are now Basic, Core, Plus and Advanced — previously Personal, Business, Commerce Basic and Commerce Advanced. Code Blocks exist on every plan, but Squarespace treats JavaScript inside one as a premium feature available on Core and above, and gates Code Injection the same way. There is no way to run a third-party widget on Basic. The 14-day trial does include the premium custom-code features, so you can test the widget before you buy — trial sites simply are not indexed by search engines. Downgrading later does not delete your code, but it does stop working; Squarespace does not document whether the block goes inert or starts printing the snippet as text, so check the live site after any plan change.
In Sorraia, add the website and verify it — a DNS TXT record, or a meta tag in your homepage’s <head>. Verification is what lets you attach a widget to that site, so it comes before there is anything to paste.
Save the agent, then copy the snippet from the Embed code box in the right-hand panel of the chat builder. (Chat has no install wizard — the box is the whole thing.)
Check the plan first. Code Injection needs Core, Plus or Advanced (Squarespace also allows some legacy billing plans, without saying which); it is unavailable on Basic.
Go to Website → Pages, scroll to the very bottom of the Pages panel, and click Custom Code → Code Injection. On a Squarespace 7.0 site that same section is called Website Tools.
Paste the Sorraia snippet into the Footer field and Save. Footer injects before the closing </body> on every page, so the markup already exists when the script runs.
Open the live site in a private window to check — logged in, Squarespace strips the script.
That is the path most tutorials still print, and it is the one that is genuinely gone. Current 7.1 puts the panel at Website → Pages → Custom Code → Code Injection; Squarespace 7.0 sites still label the same section Website Tools, which is why the old name survives in help-centre URLs.
What you get
A chat agent that answers from your own content, floating in the corner of every page on Squarespace — with 200 conversations a month included on the $19 plan, and a person able to take over at any point.
200 conversations a month on the $19 plan
The monthly allowance is 25 conversations on Free, 200 on Starter at $19/month, 1,000 on Growth, 5,000 on Business and 20,000 on Enterprise. A conversation counts once when it starts, not per message, and the counter resets at the start of each UTC month.
Past the cap it keeps answering, at a price you can see
On any paid plan the agent carries on past its allowance at $15 per 100 additional conversations — or part of 100, so one conversation over the line is one $15 pack, and we would rather say that than let you discover it on an invoice. Every account also carries a ceiling on how many packs it will buy, defaulting to ten ($150 of extra exposure), and at the ceiling the widget behaves exactly as it does with overage switched off. Free does not run an overage; it stops at 25.
It says it is an AI, always
Every conversation opens with a line naming the agent as your business’s AI assistant and noting that a human can take over. That line is not a setting — the widget will not render without it. When someone from your team does take over, the status changes to say so.
It answers from your site, not from the open internet
The agent is grounded in your own content, which is why it can answer a question about your pricing or your opening hours and will not invent a policy you never wrote. If a calendar is wired up it can also take a booking mid-conversation — and it only claims it can book when one actually is.
More detail in the Help Center: The AI chat agent · Embedding on your website
Things worth knowing about Squarespace
- Squarespace disables embedded scripts while you are logged in and editing, replacing the block with a notice. A working widget therefore looks dead to the site owner. Verify in a private window or via Preview in Safe Mode.
- The Code Injection panel moved out of Settings → Advanced into Website → Pages → Custom Code. Older tutorials will send you scrolling through a Settings menu that no longer has it.
- Use a Code Block only for a widget that should occupy space in the layout. A block containing a script that draws nothing in place still takes up vertical room and leaves a visible gap, most noticeably in Fluid Engine sections.
- Footer is the safer of the two Code Injection fields for a launcher, because the page already exists when the script runs. Header is not inherently slower — an async or defer tag there does not block first paint — but a synchronous snippet in Header will delay it.
Questions
What happens when I hit the monthly conversation limit?
On a paid plan, nothing visible: the agent keeps answering and the extra conversations bill at $15 per 100 — rounded up to the next pack — capped by a per-account pack ceiling you control, ten by default. On Free it stops starting new conversations for the rest of the month, and the widget degrades rather than vanishing: the panel still opens, the disclosure line corrects itself to say the assistant is offline, the message box is disabled, and your WhatsApp and email handoffs are surfaced instead. A conversation already in progress is never cut off. The visitor is never shown your plan, your usage, or the reason.
Will visitors know they are talking to an AI?
Yes, by design. The disclosure line is always rendered — it names your business, says “AI assistant”, and tells the visitor a human can step in — and it cannot be switched off in the builder. If a teammate takes the conversation over, the widget stops describing itself as the AI and says the team is live.
Can a person take over a conversation?
Yes, and the visitor is told both times. Pick up any live conversation from the Conversations page and the widget posts “A team member has joined the conversation.” and switches its status from “AI assistant · replies instantly” to “Live · with the team”. Hand it back and it says so. If whoever took over walks away, the conversation returns to the AI on its own after about ten idle minutes rather than leaving the visitor waiting on someone who has gone.
Which Squarespace plan do I need to add a widget?
Core or higher. Code Blocks appear on every plan, but Squarespace only allows JavaScript inside one on Core, Plus and Advanced (and on the legacy Business and Commerce plans), and Code Injection has the same gate. On Basic the block accepts plain HTML, Markdown and CSS but will not run a script. Squarespace’s 14-day trial does include the premium custom-code features, so you can test the widget before you buy — trial sites just are not indexed by search engines.
I pasted the code and the block says “embedded scripts are disabled”. Is it broken?
No — that is Squarespace protecting you from your own scripts while you edit. Visitors see the widget; you do not, because you are logged in. Open the live URL in a private or incognito window and it will be there.
My code prints on the page as text instead of running. What happened?
The Code Block’s Type menu is set to JavaScript. Squarespace renders the CSS, JavaScript and Plain Text types as visible source by default, and force-locks the Display Source checkbox on for them — which is why you cannot untick it. Set Type to HTML, keep the script tags around the snippet, and untick Display Source.
Add an AI chat widget to Squarespace
Build it in Sorraia, paste one line into your Squarespace site, and change it later without touching the embed again.