Add AI chat to HubSpot CMS

Installation steps

1. 1

   Prepare

   Open HubSpot settings for Website → Pages and review Templates or the site footer HTML controls available to your account.

2. 2

   Configure

   Add the complete loader to the shared template or footer field used by the public pages that need chat.

   <script src="https://mivochat.app/widget.js" data-site="YOUR_SITE_KEY" async></script>

   Copy
3. 3

   Publish

   Save and publish the template changes, then allow the public HubSpot or custom domain in MivoChat.

4. 4

   Verify

   Test a logged-out page for a source-backed answer, visitor message, and Telegram team reply.

Prefer a shared template or footer

HubSpot accounts can expose different page tools based on CMS setup and permissions. If the current Website → Pages screen does not show the named template or footer control, check HubSpot's current settings and account role instead of assuming every portal has the same editor.

Place one script in the shared template or supported footer HTML that renders the intended pages. Avoid adding it to individual rich-text modules, where code may be stripped or displayed.

<script src="https://mivochat.app/widget.js" data-site="YOUR_SITE_KEY" async></script>

Verify the deployed template

A saved template draft is not necessarily published. Open the live URL in a logged-out browser and inspect the generated HTML for the loader.

If the MivoChat script appears but the launcher does not, compare the host with Allowed websites and inspect the Console for CSP or consent blocks. Include pricing, help, and docs pages in your source tests so the assistant is useful beyond a single landing page. HubSpot page templates can have separate variants for landing pages, blog posts, and system pages. Check each template family that customers visit, especially the pricing and documentation routes, before removing an older support link or announcing the new chat entry point.

Before you change the setup

Who this is for

a HubSpot CMS owner with access to shared page templates or footer code

What you need

HubSpot settings permission, a published CMS template, and the public hostname

Where it goes

the current Settings → Website → Pages template or site footer HTML setting when exposed

Watch out for

HubSpot portal features and labels vary by CMS setup and permissions; confirm the current control

Test the support boundary

• Do intended CMS pages inherit the edited template?
• Is the footer loader in the published response?
• Does the visitor receive an answer from pricing and help content?

Related guidance

Use /guides/webflow for another CMS custom-code workflow and /guides/widget-troubleshooting to diagnose a published page.

Frequently asked questions