Hazelchat
Start free

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.

How the Hazelchat add-on works on Concrete CMS Your content, answers, enquiries and billing stay in Hazelchat. You paste your installation code into Dashboard, Hazelchat. The add-on keeps only the key and one consent setting, sends nothing from Concrete to Hazelchat, and adds one script to your public pages, where visitors get answers with their sources. Hazelchat Content, answers, enquiries and billing Your installation code You paste it into Dashboard → Hazelchat The Concrete CMS add-on The key One consent switch Reads no pages, users or forms. Sends nothing. Adds one script to every public page Your public pages A visitor's question Answer from your pages Sources (1)

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

  1. 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.

  2. 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.

  3. 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 packages folder and click Install under Extend Concrete → Add Functionality. Installing it alone loads nothing on your site.

  4. 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.

  5. 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.

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.js from 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_policy in application/config/concrete.php, or a proxy or CDN sends a policy, allow https://app.hazelchat.co in script-src and frame-src. Nothing else is needed: no style-src, connect-src, 'unsafe-inline' or nonce.

  • Local and staging copies

    The chat opens only on the website addresses verified in Hazelchat. On localhost or 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.