Add an AI chat agent to your WordPress site
Hazelchat answers your visitors from the pages and documents you approved, and shows the sources under every answer. The free plugin from WordPress.org adds it to your site: no theme editing.
The Free plan includes 50 answers a month on one website, with no card.
What to look for in a WordPress chat plugin
Chat plugins work in very different ways. These questions tell them apart, and this is how Hazelchat answers them.
Where do the answers come from?
Only from the pages, documents and written answers you approve, with the source under every answer. If your content doesn’t cover a question, the agent says so instead of guessing.
What happens when it can’t answer?
Visitors can leave an enquiry with their name, email and message, or reach you through live chat in Telegram. Nobody hits a dead end.
Can you check it first?
You build and test your agent in Hazelchat. Visitors see nothing until you publish and switch it on.
Does it work with your cookie banner?
Complianz, Real Cookie Banner and Borlabs Cookie are covered below, and any other banner can hold the chat back with one event.
Does it weigh down your site?
The plugin adds one script to your public pages, and it loads after the page itself. Its only screen is Settings → Hazelchat.
What does it cost?
The plugin is free on WordPress.org. The Free plan includes 50 answers a month on one website, with no card. Paid plans are on the pricing page.
What you need
- A self-hosted WordPress site, version 6.3 or later with PHP 7.4 or later. On WordPress.com you need a plan that allows plugins.
- Permission to install plugins and change settings on the site.
- A Hazelchat account. The Free plan includes 50 answers a month on one website, with no card.
Add Hazelchat to WordPress in six steps
-
In WordPress
Install the plugin
Go to Plugins → Add New Plugin, search for Hazelchat, then install and activate it. Activating it alone loads nothing on your site.
-
In Hazelchat
Prepare your agent
Add your content, check the details and try your agent. Under Website → Install on your website, add your website's domain.
Real capture of Sources in a rehearsal workspace. -
In Hazelchat
Copy your public widget key
Copy the 64-character
data-agentvalue from Hazelchat's installation code. This is your public widget key, not a password. -
In WordPress
Paste the key and switch loading on
Open Settings → Hazelchat. Paste the key, accept the hosted-service connection, turn on Load Hazelchat on public pages and save.
-
In WordPress
Remove old snippets, clear the cache
If you pasted a Hazelchat script into your theme before, remove it. Then clear your page cache.
-
On your site
Switch it on and test it
Back in Hazelchat, click Publish and switch on (or Switch on if your published agent is unchanged). Hazelchat checks that the script is on your website before the agent goes live. Then click the button that opens your website, such as Open example.com. Ask a question in the chat, return to Hazelchat and click Yes, I saw this answer.
What the plugin does
It adds one script to your public pages and nothing else. Your content, answers, enquiries and billing all stay in your Hazelchat workspace.
The script is https://app.hazelchat.co/widget.js, with your public key, in the footer of your public pages. The plugin stores only that key and three on/off settings. It does not read your posts, users, orders or carts, and it sends nothing from WordPress to Hazelchat. The WordPress admin, feeds and draft previews never load the chat.
Visitor consent
If your cookie banner has a service named Hazelchat, the chat follows it: it loads once a visitor agrees and disappears when they withdraw. Which banners.
- Complianz: nothing to do. The plugin lists Hazelchat in Complianz, which holds the chat back until visitors agree.
- Real Cookie Banner: add a service named Hazelchat.
- Borlabs Cookie: add a service named Hazelchat with the ID
hazelchat, then tick Wait for my cookie banner before the chat loads. in Settings → Hazelchat.
For another banner, tick the same box under More and have your banner send this once a visitor agrees:
window.dispatchEvent(new CustomEvent('hazelchat-consent', { detail: true }));
Send detail: false when a visitor withdraws consent. The small launcher script still downloads before consent; if your site must block that too, let your banner block the script.
Caching and optimisation plugins
Clear the page cache
After you install, change the key or remove the plugin.
Leave the script alone
Exclude
https://app.hazelchat.co/widget.jsfrom script combining, rewriting or delayed loading. The script must keep its own address and key.Keep
wp_footer()Your theme must call it, which almost every theme does.
Content-Security-Policy
If your site sends one, allow
https://app.hazelchat.coinscript-srcandframe-src.
Change or remove
New widget key
If you rotate the key in Hazelchat, paste the new one in Settings → Hazelchat and clear your cache.
Pause the chat
Switch Hazelchat off in your workspace. It stops answering straight away, even on cached pages.
Remove it from the site
Turn off loading, or deactivate the plugin. Deactivating keeps your settings; deleting the plugin removes them. Your Hazelchat account and plan are not affected.
Questions
Is the plugin free?
Yes. The plugin is free on WordPress.org, and Hazelchat’s Free plan includes 50 answers a month on one website, with no card.
Does it work with WooCommerce?
Yes. The agent answers from your public shop and product pages, with a link to the page it used.
Does it work with Elementor, Divi or a block theme?
Yes, as long as your theme calls wp_footer(), which almost every theme does. The plugin adds its script there, so you don’t need a block or widget in your page builder.
Which languages does it speak?
English, German, Dutch and Spanish. You choose which ones visitors can use.
Can I use it on more than one site?
The Free plan covers one website. Paid plans add more websites, more answers and enquiry emails.
Let your WordPress site answer from its own pages.
Questions? Email hello@hazelchat.co. We answer within one business day. Not on WordPress? There are apps for Wix, Webflow and Framer, an extension for Joomla, and a guide for any other website. See all the ways to install Hazelchat.