Add Hazelchat to your Ghost site

Add Hazelchat’s chat agent to every page of your Ghost publication with Ghost’s Code injection. Hazelchat answers your visitors from the pages and documents you approved, and shows the sources under every answer.

What you need

A Ghost site, on Ghost(Pro) or self-hosted. Ghost(Pro) Starter allows only official themes and basic third-party services, so on Starter check that Code injection appears in Settings.
Self-hosted with your own theme: the theme must output Ghost’s {{ghost_foot}} helper before the end of the page, as Ghost’s theme documentation requires.
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 Ghost Admin, open Settings and find Code injection (in the Advanced section).
Paste the line into Site footer, not Site header. Ghost adds it before the end of every page and recommends the footer for scripts.
Click Save.
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 Ghost’s own help (How to use code injection in Ghost, Code injection and styles and ghost_head and ghost_foot), read on 14 October 2026. We have not yet tested Hazelchat on Ghost ourselves. If a menu looks different, Ghost’s page is the up-to-date one.

Check it works

Open your site signed out of Ghost Admin and view the page source: the line appears near the end.
Posts and pages also have their own code injection, which applies to that one post. Keep Hazelchat in the site-wide footer.

Ghost’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

No Code injection on Starter. Ghost(Pro) Starter limits third-party services. See Ghost’s pricing page for what your plan includes.
A custom theme without ghost_foot. On a self-hosted site, footer code appears only if the theme outputs {{ghost_foot}}.
“The install script was not found on the page.” Check that you published the change in Ghost and that the line is complete, with your own key, then try again in Hazelchat.

Ghost sets no non-essential cookies by default and has no cookie banner of its own; Ghost suggests a consent tool such as CookieYes. Nothing in Ghost holds back code you add.

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

Open Settings → Code injection, delete the line from Site footer and click Save.
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 Ghost itself, use Ghost’s help center. For anything in Hazelchat, email hello@hazelchat.co. We answer within one business day. Other ways to install Hazelchat.

Start free