The 60-second HubSpot chatbot path
HubSpot CMS Hub gives you three custom-code slots out of the box: Site header HTML, Site footer HTML, and page-level Footer HTML inside the page editor. Any of these works for a chatbot script tag, and the install takes about 60 seconds.
The chatbot snippet is one line:
<script async src="https://chatraj.com/widget.js" data-bot-id="YOUR_BOT_ID"></script>
The recommended path: open the gear icon, Settings, Website, Pages, scroll to the Templates tab, scroll down to Site footer HTML. Paste the script tag. Hit Save. The chatbot bubble now appears in the bottom-right corner of every page of your CMS Hub site within seconds.
That's the entire integration. No HubSpot App to install, no permission scope to grant, no module to add to your theme, no template Liquid to retrain your team on. The widget loads asynchronously after your page renders, never blocks Largest Contentful Paint, and shows up on every page that includes your site's published footer template (which is every page, by default).
HubSpot Chatflows vs ChatRaj: honest comparison
HubSpot ships its own chatbot, and Marketing Hub buyers reasonably ask why they need ChatRaj if Chatflows is right there in the CRM. The honest answer depends on which HubSpot tier you're on:
Free and Starter tiers (HubSpot Chatflows). HubSpot's free Chatflows are rule-based "if/then" bots. Visitor types A, bot responds B. They work well for very simple flows (qualifying visitor intent, routing to forms) but cannot answer free-form questions from your content. If you want a bot that can answer "what's your enterprise pricing?" or "how does the Webflow integration work?" by reading your published pages, the free tier won't do it. ChatRaj does this on its free plan.
Marketing Hub Professional and above (Breeze Customer Agent). HubSpot's AI chatbot lives behind Marketing Hub Professional, which currently starts at roughly $800/month plus mandatory onboarding (around $3,000 one-time) plus per-conversation AI costs (each Breeze conversation consumes HubSpot Credits, priced around $1 per conversation at standard rates as of mid-2026). For a high-volume B2B site, that adds up: a thousand chatbot conversations per month easily clears $1,800 in AI costs alone, on top of the $800 platform fee.
ChatRaj's Pro plan is $29/month for 10,000 messages (with no per-message overage, just a fixed monthly quota). For most SMBs and even mid-market HubSpot operators, that's the same outcome (AI chatbot trained on your published content) for roughly 1-5% of the HubSpot Marketing Hub Professional + Breeze cost. Where Breeze pulls ahead is deep CRM-linked workflows: Breeze can read live HubSpot contact properties and trigger HubSpot workflows directly. ChatRaj does not yet have a deep CRM integration (we plan to ship one in 2026 via webhook + Zapier path).
The honest split: if you're already paying for Marketing Hub Professional AND your bot needs to read live HubSpot contact data, stay with Breeze. If you're on Free, Starter, or just want an AI chatbot on your site without the Marketing Hub Professional upgrade, ChatRaj is built for you.
Where to paste the script tag (three options)
You have three good places to paste the embed code, depending on whether you want the bot to appear site-wide or only on specific pages:
Option A: Site footer HTML (recommended, site-wide bubble). Open the gear icon (top-right of HubSpot), Settings, then Website, Pages. Click the Templates tab. Scroll down to the Site footer HTML field. Paste the script tag. Hit Save. The chatbot bubble now appears on every page of your CMS Hub site. This is the standard pattern for site-wide tools.
Option B: Page-level Footer HTML (single-page bubble). If you only want the chatbot on, say, your Pricing page or your developer-docs hub, open that page in the page editor, click Settings (top of the editor), then Advanced. Scroll to Additional code snippets, find the Footer HTML field. Paste the script tag. Hit Save and publish the page.
Option C: Template-level (advanced). If you maintain your own HubSpot templates via the Design Manager, you can drop the script tag directly into the template's HTML right before the closing body tag. This is the cleanest install for teams already maintaining custom HubSpot templates, but requires Design Manager access and a careful publish workflow.
Will it work on my HubSpot theme?
Yes. ChatRaj's widget is an iframe rendered above all your CMS Hub content via z-index 2147483647 (the maximum 32-bit signed integer, so no other element on the page can sit on top of it accidentally). It does not import any CSS into your theme, does not add classes to your body element, and does not load fonts that conflict with your HubSpot design system.
We've verified the script on the marketplace's most-installed CMS Hub themes (Atomic, Forj, Boldgrid, Lyssna, ProRain, Avian, and the official HubSpot starter themes) plus a number of custom-built templates. The widget renders correctly above HubSpot's standard global modules (header, footer, navigation), HubSpot forms, CTA blocks, and rich-text content blocks. The only conflicts we've seen are a handful of older custom themes that override z-index on body elements (unusual; most HubSpot template developers don't touch root-level z-index).
If you hit a z-index conflict, the fix is a one-line CSS override added to your theme's stylesheet (or to the Site header HTML in the same settings panel): #chatraj-iframe { z-index: 2147483647 !important; }. If you hit this, ping support.
Lead capture, ungated, plus the CRM-flow angle
HubSpot CMS Hub buyers are already paying for CRM and marketing automation, so the obvious question is: how does ChatRaj's lead capture flow into HubSpot Contacts?
For the immediate term: ChatRaj captures emails to a CSV export and a webhook of your choice. The webhook path is the bridge to HubSpot. Operators today use either Zapier (HubSpot has a first-class Zapier connector) or HubSpot's own native webhook endpoints (via HubSpot Workflows on Marketing Hub Professional) to push ChatRaj-captured emails directly into HubSpot Contacts. The webhook payload includes the visitor email, name (if captured), the conversation transcript, and the page URL where the conversation started.
For teams that don't want to wire webhooks: the CSV export is exportable on demand from the Leads tab in the ChatRaj dashboard. Most marketing teams import the CSV into HubSpot weekly. We plan to ship a native HubSpot Contacts integration later in 2026 that removes this manual step.
For lead routing inside HubSpot, the captured visitor's email becomes a standard HubSpot Contact and flows through whatever marketing automation, lifecycle stage updates, and lead-scoring rules you already have configured. The chatbot is upstream of your existing HubSpot funnel, not a replacement for it.
Multi-language CMS Hub sites
If you run a multi-language HubSpot CMS Hub site (using HubSpot's built-in language switcher and multi-language page variants), ChatRaj auto-detects the visitor's language from their first message and replies in the same language. No configuration needed. Hindi, Spanish, Japanese, German, Portuguese, Mandarin, French, Italian, Arabic, and 90+ other languages are supported out of the box.
For locale-specific answers, the bot reads the language variant of each page that the visitor is browsing. A visitor on your German page variant gets answers in German based on the German-localized content. The bot's training crawl indexes each language variant separately during ingestion.
If your audience is mono-lingual (for example, a Germany-only B2B brand on a single German CMS Hub site), you can set a per-bot Force response language in Settings so the bot always replies in German regardless of what the visitor types. That setting overrides the auto-detect rule and is useful when you want a consistent UX even if a curious tester types English at your German-first site.
GDPR, cookie consent, and HubSpot's existing consent banner
HubSpot CMS Hub ships with a built-in cookie consent banner (Settings, Privacy & Consent). If you've enabled it, your visitors see HubSpot's consent flow before any tracking scripts run. ChatRaj's widget should be folded into this consent layer.
The simplest pattern: keep ChatRaj in the Site footer HTML, and add a small wrapper that delays the script until consent is granted. Most operators use HubSpot's native consent.js callbacks to fire the chatbot script after the visitor accepts functional cookies. The chatbot's cookie (a random visitor_id for conversation continuity) falls under functional cookies in most jurisdictions, so it does not require explicit opt-in beyond the standard "accept" path.
For paid customers, ChatRaj signs a Data Processing Agreement (DPA) and stores conversation data in the EU on request, in line with the standard processor-controller split under GDPR Article 28.
Compatibility with HubSpot forms, CTAs, and the rest of the CMS stack
The chatbot widget runs in an iframe and does not touch your HubSpot CMS Hub render path. That means:
- HubSpot forms render and submit normally. The chatbot does not intercept form submissions or modify form HTML.
- HubSpot CTAs (smart CTAs included) render and respond to visitor segments normally. The chatbot does not affect CTA personalization rules.
- Smart Content (page personalization) continues to work as configured. The bot reads the version of the page the visitor sees during the conversation and answers based on that.
- Marketing Hub email tracking (the HubSpot tracking script) runs independently of the chatbot script. Both can coexist in the Site footer HTML.
In short: the chatbot is a separate layer that does not interfere with anything HubSpot is already doing. Teams that run multi-domain CMS Hub setups (blog on one domain, marketing site on another, knowledge base on a third) can either install one ChatRaj bot per domain with separate Allowed Origins, or share a single bot across all three by adding every domain to the same bot's Allowed Origins list.
When you should NOT use ChatRaj on HubSpot CMS Hub
A few honest signals that ChatRaj might not be the right fit for your HubSpot setup:
- You need the chatbot to read live HubSpot Contact properties (lifecycle stage, deal value, custom fields) and personalize answers based on them. HubSpot's Breeze Customer Agent on Marketing Hub Professional does this; ChatRaj does not yet.
- You need real-time CRM workflow triggers from the chatbot (e.g. "if visitor says X, move them to Lifecycle Stage Y"). Again, Breeze + HubSpot Workflows is the native path.
- You're locked into Marketing Hub Enterprise for unrelated reasons and have unused Breeze Credits to burn. Use what you've already paid for.
For everyone else, especially Free, Starter, and Marketing Hub Professional teams that just want a content-grounded AI chatbot without the Breeze per-conversation costs: ChatRaj's 60-second install path is real, and the free tier is enough to confirm whether the bot's answers from your HubSpot pages are good enough before you spend a dollar.