Add Hazelchat to your Carrd site

Add Hazelchat’s chat agent to your Carrd site with one hidden Embed element. Hazelchat answers your visitors from the pages and documents you approved, and shows the sources under every answer.

What you need

Carrd Pro Standard or higher. Carrd’s free plan and Pro Lite do not include embeds.
A Hazelchat account with an agent you have tried in the workspace. You can start free.

Add the code

In Hazelchat, open the install step (Install in setup, or Website → Install on your website), choose Something else and click Copy the code. It is one line with your own widget key:
```
<script src="https://app.hazelchat.co/widget.js" data-agent="YOUR-WIDGET-KEY" defer></script>
```
In the Carrd builder, click Add Element and choose Embed.
Set Type to Code and paste the line into Code. Label it Hazelchat so you find it again.
Set Style to Hidden and choose Body End. A hidden embed shows nothing where you placed it, so one element covers the whole site.
Publish the site.
Back in Hazelchat, enter your website’s address and click I’ve added the code.
Click Publish and switch on (or Switch on if your agent is already published). Hazelchat first looks for the code on your website and only then makes the chat visible.
Open your website, refresh it, ask the chat a question a visitor would ask, then return to Hazelchat and click Yes, I saw this answer.

These steps follow Carrd’s own help (Embedding custom code and Pro plans), read on 14 October 2026. We have not yet tested Hazelchat on Carrd ourselves. If a menu looks different, Carrd’s page is the up-to-date one.

Check it works

Check the published site: the builder shows nothing for embeds.
If the published site looks unchanged, hard-refresh it (Ctrl+Shift+R, or Cmd+Shift+R on a Mac).

Carrd’s help says this code goes into the page itself, so Hazelchat’s check can find it when you switch the chat on. If your home page does not carry the code, enter the page that does under Installation troubleshooting → Page the script is on.

Common problems

Type set to IFRAME. An iframe embed would put the chat in a box. Use the Code type.
A typo breaks the site. Carrd warns that invalid code in an embed can stop the site from loading. Paste the line exactly as Hazelchat gives it.
Several Carrd sites. Each site needs its own embed. Each yourname.carrd.co address is a separate website in Hazelchat.
“The install script was not found on the page.” Check that you published the change in Carrd and that the line is complete, with your own key, then try again in Hazelchat.

Carrd has no cookie banner of its own. If you use a consent tool on your Carrd site, connect it with the option below.

To keep the chat closed until a visitor agrees, add data-require-consent="true" to the line, before defer. The chat then waits until your consent tool sends:

window.dispatchEvent(new CustomEvent('hazelchat-consent', { detail: true }));

Send detail: false when a visitor withdraws consent. With this option and no event, no chat appears, so test it on your published site.

Remove Hazelchat

Delete the Embed element (labelled Hazelchat if you named it) and publish the site.
To hide the chat everywhere at once without touching your site, switch Hazelchat off on its Website page. The line then stays on your pages but shows nothing.

Help

For Carrd itself, use Carrd’s docs. For anything in Hazelchat, email hello@hazelchat.co. We answer within one business day. Other ways to install Hazelchat.

Start free