ChatRaj
AI Chatbot for beehiiv

Add an AI chatbot to your beehiiv site in minutes

ChatRaj trains on your public beehiiv archive and embeds via Settings, Advanced, Code Injection. Readers ask questions, find old posts, and subscribe to your newsletter inside the chat.

Read install steps
Bottom line
beehiiv publications run on a public website with a searchable archive, and that archive is exactly what a chatbot can answer from. On a paid beehiiv plan (Scale or Max), open Settings, Advanced, Code Injection, paste one ChatRaj script tag into the Footer field, and save. The bubble appears on every page of your beehiiv site and helps subscribers find old posts, learn what you cover, and join the newsletter inside the chat.
Reviewed by ··9 min read
Jump to section

Why beehiiv newsletters need an AI chatbot on their website

beehiiv started as a newsletter platform, but in practice every beehiiv publication is also a website. Every post you send becomes a public URL on your beehiiv site (or your custom domain), the archive is indexed by Google, and a growing share of your traffic arrives by search rather than by inbox. That shift is the reason an AI chatbot makes sense on a beehiiv publication in 2026.

When a new reader lands on a single post via Google, social, or a referral link, they almost never browse your archive afterward. They read the one post, hit back, and leave. A chatbot fixes the discovery problem in a way that on-page navigation never has: a single sentence ("do you have anything on cold email deliverability?") returns three matching posts from your archive, even if those posts were sent eighteen months ago and live four scroll-pages deep in the homepage feed.

The chatbot also doubles as a newsletter-signup engine. beehiiv already has a strong native subscribe form, popup, and slide-in. ChatRaj is not a replacement for those. It is an additional surface that captures the readers who would never click a banner but will type a question. Reader asks, chatbot answers from your archive, chatbot suggests the newsletter, reader subscribes inside the chat. That entire flow happens without the reader ever leaving the post they landed on.

For a newsletter operator running a beehiiv site in 2026, the chatbot is mostly an archive-search tool with a signup hook attached. That framing keeps expectations honest and makes the install worth doing.

What "AI chatbot for beehiiv" specifically means

There are two very different beehiiv chatbot conversations and it helps to separate them up front.

The first conversation is about the email itself. Can an AI write your next newsletter? Can it draft headlines, suggest subject lines, or summarize a draft? beehiiv already ships native AI for that inside the editor and rolled out an AI website builder plus a native MCP integration in 2026 that lets tools like Claude and ChatGPT connect to your beehiiv account. None of that is what this page is about. ChatRaj does not write your emails and does not replace beehiiv's editor AI.

The second conversation is about your public website. When a reader visits yourpublication.beehiiv.com (or your custom domain) and lands on a post, what helps them stay, read more, and subscribe? That is the gap a website chatbot fills. ChatRaj reads your public beehiiv archive, embeds as a floating bubble on every page, and answers reader questions grounded in your published posts. That is the use case this guide covers, and it is the use case the install path below is designed for.

A few specific things ChatRaj does on beehiiv:

  • Crawls your public post archive (free posts, the public preview portion of paid posts, your about page, any standalone pages you have published).
  • Renders as a floating chat bubble on every page of your beehiiv site, including individual posts, your homepage feed, the archive listing, the about page, and any custom landing pages.
  • Answers reader questions in natural language, grounded only in your content, with citations back to the source post.
  • Offers a newsletter signup inside the conversation when the topic is a natural fit, captures the email, and forwards it to your beehiiv list via webhook or CSV.

What ChatRaj does not do on beehiiv: it does not read paid-only post content, does not edit your beehiiv site, does not send emails on your behalf, and does not modify your subscriber list directly.

ChatRaj on beehiiv: install via custom HTML / Code Injection

beehiiv exposes a Code Injection panel in Settings, Advanced. This is the canonical place to drop site-wide third-party scripts on a beehiiv publication, and it is where the ChatRaj loader goes. The flow inside beehiiv:

  1. Sign in to your beehiiv dashboard.
  2. Click Settings in the left sidebar.
  3. Open the Advanced section.
  4. Find Code Injection.
  5. Paste your ChatRaj script tag into the Footer field.
  6. Save.

The script tag itself is the same one-line loader used across every other platform integration:

html
<script async src="https://chatraj.com/widget.js" data-bot-id="YOUR_BOT_ID"></script>

The Footer slot injects code just before the closing body tag on every page of your beehiiv site. That is the correct placement for an async chat-widget loader because it never blocks the initial render and it is guaranteed to appear on every page including new posts you publish later. There is no per-post step. Once the tag is in the site Footer, every post you send is auto-instrumented from the moment beehiiv publishes the public URL.

One thing worth calling out: beehiiv's site-wide Code Injection panel is gated by plan tier. On the free Launch plan, site-wide script injection in Settings, Advanced is not available, which means the script-tag install path does not work on Launch out of the box. The feature unlocks on a paid plan (Scale, starting around forty-nine dollars per month at the entry subscriber tier, or Max at higher tiers). If you are on Launch and not ready to upgrade, the install is gated; see the gotchas section below for the honest workaround paths.

For publishers on a paid beehiiv plan, the install is roughly two minutes end to end, most of which is signing in to beehiiv and navigating to the Code Injection panel.

What ChatRaj reads from a beehiiv site (archive posts, about page)

The ChatRaj crawler reads your public beehiiv URLs the same way Googlebot does: it loads pages anonymously and indexes whatever the public viewer sees. On a typical beehiiv publication, that means:

  • Every public post in your archive (the bulk of the training corpus).
  • The public preview portion of any paid-only or members-only posts (anything above the paywall).
  • Your about page if you publish one.
  • Any standalone pages you have built in beehiiv's website builder.
  • Your homepage feed, archive listing, and tag pages, which the crawler uses to discover posts.

For most newsletter publishers, the archive is by far the largest portion of public content and becomes the bulk of what the bot can answer from. ChatRaj's default crawl picks up the first batch of pages from your sitemap; if you have a deep archive (hundreds of posts) you can submit your full sitemap URL inside the ChatRaj dashboard so the crawler indexes every post rather than just the most recent ones. beehiiv generates a sitemap automatically for every publication, usually at the publication root with sitemap.xml appended.

The crawler does not read content that beehiiv serves only to logged-in or paid subscribers. If your business model is mostly behind a paywall and the public preview portion is thin, the bot will have less to work with. For the common pattern of free-with-occasional-paid posts, the bot has plenty of archive content to ground its answers in.

Lead capture: how the chatbot complements beehiiv's newsletter signup

beehiiv already does subscribe forms well. The native inline form, the popup, and the slide-in cover most of the standard newsletter-signup placements, and the conversion rates on those forms are usually fine. The chatbot is not a replacement for those forms. It is an additional surface.

The pattern that works on beehiiv:

A reader lands on a post via Google, finishes reading, and has a follow-up question that the post didn't quite answer. The native popup may or may not have fired by then. The chatbot bubble in the corner is always there. The reader types the question, the bot answers from a related post in your archive, and at the natural end of the conversation the bot offers the newsletter: "Want a weekly post like this? Drop your email." If the reader says yes, the bot captures the email and forwards it to your beehiiv list via webhook or CSV export.

The webhook can route into beehiiv's subscriber API directly (beehiiv exposes a Create subscriber endpoint that adds a new email to a publication), or it can route through Zapier or Make if you prefer a no-code path. Either way the captured email lands in your beehiiv list and joins your normal welcome automation just like any other signup.

The reason this matters: the readers who type a question and the readers who fill a popup form are usually not the same readers. The chatbot reaches a different cohort, captures emails the popups never would have caught, and the two surfaces stack rather than cannibalize.

Helping subscribers find old articles (the killer use case)

This is the use case that justifies the install on its own.

Most newsletters publish for years before realizing the archive is their most valuable asset. A two-year-old newsletter has a hundred-plus posts of evergreen content, almost none of which is reachable from the homepage feed beyond the first scroll page. Readers who arrive on one post almost never find the older ones.

ChatRaj turns the archive into a conversational search index. A reader types "have you written anything about cold open rates?" and the bot returns the three most relevant posts from your full archive, with one-sentence summaries and direct links. That single interaction is worth more than a generic site search bar because the bot returns matched posts even when the reader's wording does not match your post titles or tags.

A few patterns that work well on beehiiv specifically:

  • Topic drill-down. Reader asks a broad question; bot returns three related posts grouped by sub-topic; reader picks one and follows up with a narrower question.
  • Onboarding recommendations. "What should I read first if I'm new here?" returns your highest-signal posts ordered by sequence.
  • Comparison answers. "Have you covered Substack vs beehiiv?" returns your comparison post even if the headline doesn't include both names.
  • Long-tail topic match. "Anything on B2B email deliverability for cold outreach?" finds the one March 2024 issue that buried the topic in a sub-section.

The archive-search pattern is also what differentiates ChatRaj from generic site search. Search returns a list of post titles; the bot answers the question and points at the post that answers it best.

beehiiv ships several AI-flavored features in 2026, and it is worth being clear about where they overlap with ChatRaj and where they do not.

beehiiv's native search (the search bar on your public site) returns matching posts by keyword and is improving steadily; the platform rolled out new search and sort controls in early 2026 and has been adding richer search experiences across the website builder. The native search is good for a reader who already knows the exact phrase they are looking for. It does not answer questions, does not synthesize content across multiple posts, and does not capture email signups.

beehiiv's AI website builder is a different feature; it helps the operator build the site itself, generate pages, and edit HTML output. You describe what you want and the AI generates the layout. It is an authoring tool for the publisher, not a reader-facing chatbot.

beehiiv's native MCP integration (launched in 2026) lets external AI tools like Claude and ChatGPT connect to your beehiiv account so you can manage the publication via conversation. That is operator-facing, not reader-facing. A reader on your public site does not gain anything from MCP; it helps you the publisher manage beehiiv via Claude or ChatGPT.

ChatRaj sits in a different spot: a reader-facing chatbot grounded in your public archive, embedded on the website itself, designed to be the first thing a confused or curious reader interacts with. There is no overlap with the operator-facing AI features and only partial overlap with native search (the bot answers questions; native search retrieves titles).

For most beehiiv publications, both can coexist. Keep the native search bar for readers who already know what they want; add ChatRaj for the much larger group who would rather type a question.

Common gotchas (Free vs Scale tier, post-only sites, archive depth)

A few honest gotchas worth flagging before you start.

Code Injection is a paid-tier feature. On beehiiv's free Launch plan, site-wide Code Injection in Settings, Advanced is gated. The script-tag install path requires Scale (entry pricing around forty-nine dollars per month at the lowest subscriber tier) or Max (around one hundred and nine dollars per month). If you are on Launch and not ready to upgrade, the site-wide install is blocked at the platform level. ChatRaj has a free tier of its own that works on top of any paid beehiiv plan, but it cannot bypass beehiiv's plan gate.

Post-content HTML is sandboxed. beehiiv allows custom HTML inside individual post bodies via the HTML Snippet block, but script and style tags are stripped from post-body HTML for safety. That means you cannot install the chatbot by pasting the script tag into an individual post body; the only working site-wide path is Settings, Advanced, Code Injection.

Archive depth. ChatRaj's default crawl picks up the first batch of pages. If you have a deep archive (several hundred posts), submit your beehiiv sitemap URL inside the ChatRaj Sources tab so the crawler indexes the full archive rather than stopping at the recent feed.

Custom domain. If your beehiiv publication runs on a custom domain (yourpublication.com) rather than the default beehiiv subdomain, the install path is identical. Code Injection lives on the publication, not on the domain, so the script tag flows through to whichever domain serves the public site.

Mobile rendering. beehiiv's default theme handles mobile cleanly and the chatbot bubble renders correctly on mobile widths without overlapping the native subscribe banner. If you have heavily customized your beehiiv theme with additional fixed-position UI on mobile, double-check the corner placement on a real device after install.

Cache propagation. beehiiv runs hosted publications behind a CDN, and after you save a new Code Injection entry the cached page may keep serving the previous HTML for up to a minute. If the bubble does not appear immediately, hard-reload the page (Ctrl+F5 or Cmd+Shift+R) once to force a fresh fetch.

When ChatRaj is NOT the right call (you're newsletter-only with no public archive)

A few honest signals that ChatRaj is probably not the right fit for your beehiiv setup.

You publish to email only and have the public website disabled or heavily restricted. beehiiv lets you turn off the public site or gate the archive entirely; if you do that, the bot has nothing public to train on and cannot embed anywhere a reader can reach it.

Your entire archive is paid-only with thin or no public previews. The crawler reads public content only, and if the public surface is small, the bot's answers will be shallow. You can still install it for the signup-capture surface, but the archive-search use case (the main reason most beehiiv publishers run it) will not pay off.

You are on the free Launch plan and not planning to upgrade in the near term. Without paid-tier Code Injection, the site-wide install does not work, and there is no equivalent path on Launch. The workaround is to host a separate landing page elsewhere (a Framer page, a static HTML page on Vercel or Cloudflare Pages) with ChatRaj embedded there and link to it from your beehiiv navigation, but that routes readers off the beehiiv site, which dilutes engagement signals and analytics.

You publish fewer than ten posts a year and your archive is too small for the bot to add discovery value. At low archive volume, native search and the homepage feed are enough and the bot is overkill.

For everyone else, especially beehiiv publishers on Scale or Max with a deep public archive, the install takes minutes, the free ChatRaj tier is enough to confirm whether the bot's answers from your archive feel useful before any spend, and the reader-facing surface is something the native beehiiv features simply do not cover.

Install guide

Install on beehiiv

7 steps. Most operators finish in 60 seconds.

  1. Confirm your beehiiv plan supports Code Injection

    Site-wide Code Injection is a paid feature in beehiiv. Confirm your publication is on the Scale or Max plan (Launch does not expose the site-wide Code Injection panel). If you are on Launch, upgrade beehiiv first; otherwise the script-tag install path is gated at the platform level.

  2. Create a ChatRaj account

    Open chatraj.com/signup and sign in with Google. Free tier, no credit card. You land on the dashboard ready to create your first bot.

  3. Create a chatbot and add your beehiiv site as a source

    Click New chatbot, give it a name (e.g. Archive Bot), then go to the Sources tab and paste your beehiiv publication URL (either yourpublication.beehiiv.com or your custom domain). For deep archives, paste the full sitemap URL so the crawler picks up every post rather than only the most recent feed.

  4. Customize the bubble for your publication

    On the Customize tab, pick a theme color that matches your beehiiv site, set a welcome message that reflects your newsletter voice, and add three to four suggested questions (e.g. What do you write about?, How do I subscribe?, Show me your best posts on X). Save.

  5. Copy the script tag from the Embed tab

    On the Embed tab, copy the Script tag option. It looks like: <script async src="https://chatraj.com/widget.js" data-bot-id="YOUR_BOT_ID"></script>

  6. Paste the script into beehiiv Settings, Advanced, Code Injection

    Open your beehiiv dashboard, click Settings, open the Advanced section, find Code Injection, and paste the script tag into the Footer field. Save. The Footer slot injects the loader just before the closing body tag on every page of your beehiiv site, including new posts you publish later.

  7. Verify the bubble on your live site

    Open your beehiiv site in an incognito window. Within a second or two, a floating chat bubble appears in the bottom-right corner. Click it, send a test question, and confirm the bot answers using content from your archive. If the bubble does not appear after Save, hard-refresh once (Ctrl+F5 or Cmd+Shift+R) to bust the cached page.

ChatRaj on beehiiv

Plugin approach vs ChatRaj approach

What you'd otherwise stitch together from a chatbot plugin + a separate analytics tool + a lead-capture tool, ChatRaj bundles by default, and ships in a single script tag.

The plugin approach

Other beehiiv chatbot tools

Typical when you install a WordPress plugin, Shopify app, or third-party chatbot widget.

  • Install method: Often require a beehiiv-specific integration that does not exist
  • beehiiv plan requirement: Same: Code Injection is gated to Scale and Max
  • Free Launch tier support: Not possible (beehiiv blocks site-wide script injection on Launch)
  • Archive search: Native beehiiv search returns post titles by keyword
  • Page-load impact: Varies
  • Custom domain: Same: injection works on either domain
  • Newsletter signup capture: Often a separate add-on
  • Paid-post content: Same: anonymous crawlers cannot read gated content
  • Mobile rendering: Varies
  • Setup time: Varies
The ChatRaj approach

One script tag. Everything bundled.

Hosted, configured, and maintained by us. You add a single line to your site.

  • Install method: Standard script tag in Settings, Advanced, Code Injection (Footer)
  • beehiiv plan requirement: Same: paid plan required for Code Injection
  • Free Launch tier support: Not possible on Launch; works on Scale and Max
  • Archive search: Conversational answers grounded in archive posts, with citations
  • Page-load impact: Async loader, no Largest Contentful Paint impact
  • Custom domain: Works identically on default and custom domains
  • Newsletter signup capture: Built-in chat-driven signup, routes to beehiiv via webhook or Zapier
  • Paid-post content: Reads public previews only; gated post bodies not crawled
  • Mobile rendering: Renders cleanly on mobile, does not overlap native subscribe UI
  • Setup time: Roughly two minutes end to end on a paid plan
FAQ: ChatRaj on beehiiv

Common beehiiv chatbot questions

No. beehiiv's site-wide Code Injection panel (the only site-wide script-injection path) is a paid feature available on Scale and Max. On the free Launch tier, Settings, Advanced, Code Injection is gated, and there is no alternate site-wide install path on beehiiv. ChatRaj's own free tier still works once you upgrade beehiiv to Scale or above. If you cannot upgrade, the workaround is to host a separate landing page elsewhere (Framer, static HTML on Vercel) with ChatRaj embedded there and link to it from your beehiiv navigation.

Was this helpful?

Ship your first chatbot in 60 seconds.

Sign in with Google and you'll be answering visitor questions before your coffee gets cold.

60-second setup · One-line install · Works on any site

Works on any website
SShopify
WWebflow
WPWordPress
SqSquarespace
FFramer
</>Plain HTML