Hazelchat
Start free

Add an AI chat agent to your Bubble app

Hazelchat answers your visitors from the pages and documents you approved, and shows the sources under every answer. A free plugin adds it to every page of your Bubble app: no HTML element, no code.

Version 1.0.0 for Bubble web apps. The Free plan includes 50 answers a month on one website, with no card, and stays free.

How the Hazelchat plugin works on Bubble Your content, answers, enquiries and billing stay in Hazelchat. You paste your public widget key into the plugin. The plugin holds only the key and one consent setting, reads nothing from your Bubble app, and adds one script to the header of every page, where visitors get answers with their sources. Hazelchat Content, answers, enquiries and billing Your public widget key You paste it into the Plugins tab The Bubble plugin The key One consent switch Reads no data types, users or workflows. Adds one script to the header of every page Your Bubble app A visitor's question Answer from your pages Sources (1)

We tried the plugin in our own Bubble test app on the Free plan on 23 October 2026: a button opened the chat, it answered a question with its source, and a second button closed it. We have not tested it in a Bubble customer’s app yet. If a Bubble screen looks different, Bubble’s own help is right.

What you need

  • A Bubble web app you can edit. The plugin works on every Bubble plan; on the Free plan your app runs on its test version only, and Live needs a paid Bubble plan.
  • The address your visitors use: your own domain, or your app's bubbleapps.io address.
  • A Hazelchat account. The plugin needs the hosted Hazelchat service; the Free plan includes 50 answers a month on one website, with no card.

Add Hazelchat to Bubble 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 app's address and copy your public widget key. It is not a password.

  2. In Bubble

    Install the plugin

    In your app's editor, open the Plugins tab, click Add plugins, search for Hazelchat and click Install. It is Hazelchat AI Chat Agent in Bubble’s plugin marketplace.

  3. In Bubble

    Paste your key

    In the Hazelchat plugin's settings, paste the key into Public widget key. Leave Wait for consent empty unless your cookie banner must allow the chat first.

  4. In Bubble

    Preview or deploy

    Click Preview to try it on your app's test version, or deploy to Live. Remove any Hazelchat script you pasted into the page header before, so the chat loads once.

  5. In your app

    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 app before the agent goes live. On a test version, name its page, for example https://your-app.bubbleapps.io/version-test. Then 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 the pages of your app and nothing else. Your content, answers, enquiries and billing all stay in your Hazelchat workspace.

The plugin adds https://app.hazelchat.co/widget.js, with your public key, to the header of every page of your app. Without a valid key the script starts nothing. The plugin holds only that key and one consent setting, reads none of your app's data types, users or workflows, and sends nothing from Bubble to Hazelchat. The chat's look, words and opening messages come from your Hazelchat workspace.

Open the chat from a workflow

The chat has its own button in the corner. To open it from your own button as well, add a workflow action:

  • Hazelchat – Open chat

    Opens the chat. An optional question is sent when a visitor's click started the workflow, otherwise placed in the chat's field.

  • Hazelchat – Close chat

    Closes the chat.

  • Hazelchat status

    An element with the states Chat is ready, Chat is open and Problem, and events for opened, closed, ready and problem.

If the chat does not appear

  • Check the key

    Paste only the 64-character public widget key, without spaces. Anything else shows nothing.

  • Live and test keys

    Bubble keeps a separate value for your test version. Paste the key into both fields if the plugin shows two.

  • Deploy again

    Plugin settings reach Live only when you deploy.

  • A second domain

    The Free plan serves one website. A bubbleapps.io address and your own domain are two websites.

Change or remove

New widget key

If you rotate the key in Hazelchat, paste the new one into the plugin's settings and deploy.

Pause the chat

Switch Hazelchat off in your workspace. It stops answering straight away.

Remove it from the app

Uninstall the plugin in the Plugins tab, remove its workflow actions and deploy. Your Hazelchat account and plan are not affected.

Updates and changes

Bubble shows new plugin versions in the Plugins tab, and you choose when to upgrade. The chat itself is Hazelchat's hosted script, which Hazelchat can update without a plugin update.

1.0.0 (20 October 2026): adds the Hazelchat chat to every page with one key; Open chat, Close chat and Visitor consent actions; the Hazelchat status element.

Hazelchat is not affiliated with or endorsed by Bubble Group, Inc. Bubble is a trademark of Bubble Group, Inc., used here only to say which platform the plugin works with.

Let your Bubble app answer from its own pages.

Questions? Email hello@hazelchat.co. We answer within one business day. Not on Bubble? See all the ways to install Hazelchat. Other guides: add an AI chat agent to any website and cookie banners.