Hazelchat
Start free

Add an AI chat agent to your Framer site

Give visitors a place to ask about your business. The Hazelchat plugin adds your agent to your published Framer site; your content and agent settings stay in Hazelchat, and every answer shows its sources.

The plugin has no separate charge. Hazelchat's Free plan includes 50 answers a month on one website.

How the Hazelchat plugin works in Framer You prepare and test your agent in Hazelchat and copy its public widget key. The Framer plugin adds Hazelchat's code to your site's Custom Code, and you publish the site in Framer. With the consent option on, the chat opens once your consent manager sends Hazelchat's event. Visitors on the published site get answers with their sources. Hazelchat Prepare, test and publish your agent Your public widget key You paste the key into the Hazelchat plugin Framer Adds Custom Code You publish Saving the plugin's code does not publish the site. With consent on: the chat opens after your consent event Your published site A visitor's question Answer from your pages Sources (1)

What you need

  • A Hazelchat account and content you have approved for your agent. Prepare the content, check your details and try the agent in Hazelchat.
  • A Framer project where you can edit Custom Code and publish the site. Framer controls those permissions and may require a paid Site plan. Free Framer-plan compatibility has not been confirmed.
  • Your installation code from Hazelchat. The plugin keeps only its 64-character public key, which gives no access to your account.

Add Hazelchat to Framer in five steps

  1. In Hazelchat

    Prepare your agent and copy the code

    Finish preparing your agent and enter your business name, privacy notice and contact details. Open Website, then Install on your website, and copy the installation code.

  2. In Framer

    Paste the code into the plugin

    Open the Hazelchat plugin in Framer. Paste the code into Public widget key and read the hosted-service disclosure. If you installed Hazelchat manually before, remove that earlier snippet yourself to avoid duplicate installs.

    The Hazelchat plugin in a Framer project: a status line saying no Hazelchat code is saved yet, a New to Hazelchat? panel with Create a free account and Log in, the Public widget key field with instructions to paste the installation code, and the option Wait for visitor consent before loading the chat frame, ticked.
    Real capture of the plugin in a Framer test project, before a key is entered.
  3. In Framer

    Set up consent and add the code

    The visitor-consent option starts on. Connect your consent manager as described below. Accept the hosted-service disclosure, then choose Add to Framer site.

  4. In Framer

    Publish your site

    Saving the plugin's code does not publish the site or the Hazelchat agent. Review any other unpublished changes before publishing.

  5. On your site

    Switch it on and test it

    Back in Hazelchat, review the saved website and click Publish and switch on (or Switch on for an unchanged published agent). Hazelchat checks before activation. Then click the button that opens your website, such as Open example.com and ask a real question in the chat. Back in Hazelchat, click Yes, I saw this answer.

Test on the published website. The Framer editor and its preview are not evidence that visitors can use your chat. Set up and verify each published address you use, including a custom domain and a Framer-hosted address.

Change or remove the widget

New public key or consent setting

Reopen the plugin, update the field or option, accept the disclosure and choose Replace widget settings. Publish in Framer, then check installation again in Hazelchat.

Remove

Choose Remove Hazelchat code, then confirm with Remove code. Publish in Framer to remove it from newly loaded pages.

Stop answers immediately

Pause the agent in Hazelchat. Already open pages can retain the chat until reloaded.

Uninstall

Remove the code and publish before uninstalling the plugin. Do not assume uninstalling alone removes published code.

The plugin manages only its own script. If you disabled that code in Framer settings, re-enable it there yourself and refresh the plugin's status. If its saved code was edited outside the plugin, review it in Custom Code settings first.

If the chat does not appear

  • Publish your latest Framer code, then load the published page again.
  • Refresh the plugin's status and check whether its code is disabled or your editing permissions have changed.
  • Check that the consent event arrives after the launcher loads.
  • In Hazelchat, confirm the correct website is allowed and verified, your agent has published content, and the agent is enabled.
  • If Framer's bottom-right badge overlaps the launcher, set Floating bubble position to Left under Website → Appearance, then save and publish in Hazelchat. Leave Framer's badge intact.
  • If you manage a Content-Security-Policy, allow https://app.hazelchat.co in script-src and frame-src. Keep your other protections in place.

Questions

What does the Framer plugin cost?

The plugin has no separate charge. Hazelchat offers an ongoing Free plan and optional paid plans; see pricing for current allowances. Framer's own plan requirements are separate.

What does my published site load?

Published pages download https://app.hazelchat.co/widget.js. Hazelchat can update that launcher without a plugin update. It loads the hosted chat frame, where questions and optional enquiries are processed by Hazelchat and its disclosed providers.

What can the plugin read or change?

The plugin reads no Framer pages, CMS content or visitor records. It stores no Hazelchat login and does not import content, publish your site or enable your agent. See the privacy notice, terms and data processing agreement.

How do I get help?

Email hello@hazelchat.co with your public website address and the wording of the error. Never send a password, private account token or model API key.

Let your Framer site answer from its own pages.

Not sure your pages answer what visitors ask? The free check shows it, with the passages. Other guides: add an AI chat agent to any website and cookie banners.