B
BlogBuddy

Documentation

Everything you need to add BlogBuddy to your blog in under 2 minutes.

Quick Start

Get BlogBuddy running on your blog in 3 simple steps:

1

Create an Account

Sign up for BlogBuddy and log into your dashboard.

2

Register Your Blog

Click "Add New Blog" in your dashboard, enter your blog name and domain (e.g., myblog.com).

3

Add the Widget

Copy the embed script from your dashboard and add it to your blog. Choose your method below.

WordPress Installation

The easiest way to add BlogBuddy to WordPress is with our official plugin.

Option A: WordPress Plugin (Recommended)

  1. Download the BlogBuddy plugin ZIP file from your dashboard
  2. In WordPress admin, go to Plugins → Add New → Upload Plugin
  3. Choose the ZIP file and click Install Now
  4. Click Activate Plugin
  5. Go to Settings → Blog Buddy
  6. Check Enable Chat Widget
  7. Paste your Blog ID from your BlogBuddy dashboard
  8. Click Save Settings

Option B: Manual Code (Theme)

If you prefer not to use the plugin, add this code to your theme's footer.php file before the closing </body> tag:

<script src="https://static.blogbuddy.ai/blog-chat.js" data-blog-id="YOUR_BLOG_ID"></script>

Replace YOUR_BLOG_ID with the Blog ID from your dashboard.

Manual Embed (Any Platform)

For any blog platform, add this single line of code before your closing </body> tag:

<script src="https://static.blogbuddy.ai/blog-chat.js" data-blog-id="YOUR_BLOG_ID"></script>

Important: Make sure your blog content is wrapped in an <article> tag for the widget to detect it automatically.

If your theme doesn't use <article> tags, add the data-blogchat="true" attribute to your content container:

<article data-blogchat="true">
  <!-- Your blog content -->
</article>

Platform-Specific Guides

Substack

  1. Go to your Substack Dashboard → Settings → Publication details
  2. Scroll to "Custom code" section
  3. Paste the embed script in the "Custom head code" or "Custom footer code" field
  4. Save changes

Note: Substack custom code requires a paid plan.

Ghost

  1. Go to Ghost Admin → Settings → Code injection
  2. Paste the embed script in the "Site Footer" section
  3. Click Save

Hugo / Jekyll / Static Sites

  1. Open your theme's base template (usually baseof.html or default.html)
  2. Add the embed script before the closing </body> tag
  3. Rebuild and deploy your site

Webflow

  1. Go to Project Settings → Custom Code
  2. Paste the embed script in the "Footer Code" section
  3. Publish your site

Squarespace

  1. Go to Settings → Advanced → Code Injection
  2. Paste the embed script in the "Footer" section
  3. Save changes

Note: Code injection requires a Business plan or higher.

Troubleshooting

Chat button doesn't appear

  • Make sure the script is loaded (check browser console for errors)
  • Verify your Blog ID is correct
  • Ensure your content is in an <article> tag or has data-blogchat="true"
  • Clear your browser cache

"Failed to connect" error

  • This is usually a temporary network issue - try again
  • Check if your domain is registered in your BlogBuddy dashboard
  • Ensure your subscription is active

"Invalid blog" or "Domain not found" error

  • Make sure the Blog ID in your script matches your dashboard
  • Verify the domain registered matches your actual blog domain
  • Try re-registering your blog in the dashboard

Widget appears but doesn't respond

  • Check if your subscription has available AI responses
  • Make sure there's actual content on the page for the AI to read
  • Try asking a simpler question

Frequently Asked Questions

Where do I find my Blog ID?

After registering your blog in the dashboard, you'll see the embed script with your Blog ID. It's the value in the data-blog-id attribute.

Does it work with private/password-protected posts?

Yes! The widget reads content from the page as it's rendered, so it works with any content visible to the reader.

Can I customize the widget appearance?

Currently, the widget uses a standard blue theme. Custom styling options are coming soon!

How many AI responses do I get?

It depends on your plan. Free Trial includes 100 responses/month, Starter includes 1,000, and Pro/Enterprise have unlimited responses.

Does BlogBuddy slow down my site?

No. The widget script is lightweight (~5KB) and loads asynchronously, so it won't affect your page load time.

Is the chat data stored?

We store basic interaction analytics (questions asked, sessions) to help you understand how readers engage with your content. We don't store personally identifiable information from your readers.

Still need help?

Our support team is here to help you get BlogBuddy running smoothly.

Contact Support

© 2026 BlogBuddy. All rights reserved.