Add an AI chat agent to your Concrete CMS site
Hazelchat answers your visitors from the pages and documents you approved, and shows the sources under every answer. A free add-on puts it on every public page of your Concrete site: no theme editing.
Version 0.9.1 for Concrete CMS 9.3.2 and later. The Free plan includes 50 answers a month on one website, with no card, and stays free.
Works with Concrete CMS 9.3.2 and later, installed from the Concrete CMS Marketplace or from its zip.
What you need
- Concrete CMS 9.3.2 or later. Version 8 is not supported.
- A Dashboard account that can install add-ons.
- A Hazelchat account. The add-on needs the hosted Hazelchat service; the Free plan includes 50 answers a month on one website, with no card.
Add Hazelchat to Concrete CMS in five steps
-
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.
-
In Hazelchat
Copy your public widget key
Choose Something else, open Use Concrete CMS and click Copy key. The key is public and is not a password.
-
In Concrete
Install the add-on
In the Dashboard, go to Extend Concrete → Get More Add-Ons, find Hazelchat and install it. Or download it from the Concrete CMS Marketplace, unzip it into your site's
packagesfolder and click Install under Extend Concrete → Add Functionality. Installing it alone loads nothing on your site. -
In Concrete
Paste the key
Open Dashboard → Hazelchat, paste the key into Public widget key and click Save. Saving clears the page cache. If you pasted a Hazelchat script under Tracking Codes before, the page asks you to remove it so the chat loads once.
-
In Hazelchat
Switch it on and test it
Back in your Hazelchat account, 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 open your website, ask a question in the chat, return to Hazelchat and click Yes, I saw this answer.
What the add-on 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 add-on puts https://app.hazelchat.co/widget.js, with your public key, before the end of every public page. It stores only that key and one consent setting, has no database tables and no blocks, and sends nothing from Concrete to Hazelchat. The Dashboard and pages in edit mode never load the chat. Its Dashboard page is in English and German, and it is free software under the MIT licence.
Visitor consent
If your consent tool must allow the chat first, open More on Dashboard → Hazelchat and turn on Wait for my consent manager. The chat then stays closed and sends no chat requests until your consent tool tells it to start:
window.dispatchEvent(new CustomEvent('hazelchat-consent', { detail: true }));
Send detail: false when a visitor withdraws consent. Many consent tools can do this for you: see cookie banners. If your site must block even the script download, let your consent tool block that script too.
Caching and security headers
Page cache
Saving on Dashboard → Hazelchat clears Concrete's page cache. Clear any proxy or CDN cache yourself.
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.Content-Security-Policy
Concrete sends none by default. If you set
security.misc.content_security_policyinapplication/config/concrete.php, or a proxy or CDN sends a policy, allowhttps://app.hazelchat.coinscript-srcandframe-src. Nothing else is needed: nostyle-src,connect-src,'unsafe-inline'or nonce.Local and staging copies
The chat opens only on the website addresses verified in Hazelchat. On
localhostor another address, the browser console shows a blocked frame (frame-ancestors) and no chat button appears. That is expected and is not your site's policy.
Change or remove
New widget key
If you rotate the key in Hazelchat, paste the new key into Dashboard → Hazelchat and save.
Pause the chat
Switch Hazelchat off in your workspace. It stops answering straight away, even on cached pages.
Remove it from the site
Empty the field and save, or uninstall the add-on under Extend Concrete → Add Functionality. Uninstalling removes its Dashboard page and settings too. Your Hazelchat account and plan are not affected.
Updates and changes
Concrete offers new versions under Extend Concrete → Update Add-Ons when the site is connected to the marketplace.
0.9.1: the settings page asks for your public widget key only; after saving it says that the last step happens in your Hazelchat account; the consent help link opens the cookie banner guide.
0.9.0: adds the Hazelchat chat to every public page with one installation code; optional wait for your consent manager; English and German.
Concrete CMS is a trademark of PortlandLabs, used here only to say which software the add-on works with. Hazelchat is not affiliated with or endorsed by PortlandLabs or the Concrete CMS project.
Let your Concrete site answer from its own pages.
Questions? Email hello@hazelchat.co. We answer within one business day. Not on Concrete? See all the ways to install Hazelchat. Other guides: add an AI chat agent to any website and cookie banners.