Hazelchat
Start free

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.

How the Hazelchat plugin works on WordPress Your content, answers, enquiries and billing stay in Hazelchat. You paste your public widget key into the plugin. The plugin stores only that key and three on/off settings, sends nothing from WordPress to Hazelchat, and adds one script to the footer of your public pages, where visitors get answers with their sources. Hazelchat Content, answers, enquiries and billing Your public widget key You paste the key into Settings → Hazelchat The WordPress plugin The key Three on/off settings Reads no posts, users, orders or carts. Sends nothing. Adds one script to the footer of your public pages Your public pages A visitor's question Answer from your pages Sources (1)

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

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

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

    Hazelchat's Sources page in a rehearsal workspace: buttons to add a website, files, a text snippet or a Q&A, and a list of imported pages with their addresses, sizes and whether each is active.
    Real capture of Sources in a rehearsal workspace.
  3. In Hazelchat

    Copy your public widget key

    Copy the 64-character data-agent value from Hazelchat's installation code. This is your public widget key, not a password.

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

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

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

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.js from 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.co in script-src and frame-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.