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.
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.ioaddress. - 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
-
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.
-
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.
-
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.
-
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.
-
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.
Visitor consent
If your consent tool lists a service named Hazelchat, the chat follows it on its own; see cookie banners. If your own banner must allow the chat first, type true into Wait for consent. The chat then stays closed and sends no chat requests until a workflow runs Hazelchat – Visitor consent with yes. Run it with no when a visitor withdraws consent.
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.ioaddress 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.