A chatbase chatbot wordpress setup lets you put an AI assistant trained on your own content onto your WordPress site. Chatbase builds a chatbot from your website pages, documents, or FAQ text, and you add it to WordPress with a small embed code or an official plugin. No custom development is needed, and most of the work happens in the Chatbase dashboard rather than in WordPress.
This guide shows chatbase chatbot wordpress embedding from creating the bot to pasting the code safely into your site.
This guide shows you how to embed chatbase wordpress the safe way. You will create and train your Chatbase agent, copy the embed code, add it to WordPress without editing theme files, check that the widget appears, and fix the most common display problems.
If you have not added any chatbot to WordPress before, read our general guide on how to add an AI chatbot to WordPress first. It explains the main setup methods.
What Chatbase Is and How It Works on WordPress
Chatbase is a hosted chatbot platform. You give it your content, such as website pages, PDF files, or plain text, and it builds an AI agent that answers visitor questions using that material. The agent lives on Chatbase servers. Your WordPress site only displays it, through a chat bubble or an embedded window, so WordPress itself does not run the AI.
A chatbase chatbot wordpress setup trains the bot on your own pages, so its answers come from your content, not from general AI knowledge.
There are two ways visitors can see the agent on your site. The chat bubble is a floating button, usually in the lower right corner, that opens a chat window when clicked. The iframe embed places the chat window directly inside a page, for example on a help or contact page. Most sites start with the chat bubble, because it works on every page and needs no layout changes.
Chatbase also offers an official WordPress plugin. With the plugin, you paste your agent ID into a settings field instead of copying a script. Both routes lead to the same chat bubble. Choose the plugin if you prefer to avoid code entirely, and choose the embed script if you already use a code snippet plugin.
Plan details change over time, so check the current Chatbase pricing page before you commit to a plan.
Chatbase’s official site lists the current plans and training options.
Before You Start: What You Need
First, you need administrator access to your WordPress site. Only an administrator can install plugins or add site-wide code. If you have an editor role, ask your site administrator to help.
Before you begin a chatbase chatbot wordpress install, have your Chatbase account and the pages you want the bot to learn from ready.
Second, create a Chatbase account with a business email your team can access. Keep the account details in your team’s password manager, not in a personal inbox.
Third, gather the content your agent will learn from. Start with your most important pages: the homepage, pricing or services page, delivery and returns policy, and your FAQ page. Remove pages with outdated prices, old policies, or contradictory information, because the agent can only be as accurate as the material it reads.
Fourth, decide what the agent should never do. It should never promise refunds, approve discounts, or give advice about a specific order. Write those limits down before you train it.
Finally, make a backup of your WordPress site before you add any code or plugin. A backup is cheap insurance if something conflicts with your theme or another plugin.
Chatbase Chatbot WordPress: Get Your Embed Code
You create the agent, give it content, test it, and then copy the code that connects it to your site.
Step 1: Create the Agent and Add Your Content
Log in to Chatbase and create a new agent. Give it a clear name that describes its job, such as your business name plus support. Then add your content sources. You can point Chatbase at your website pages, upload documents, or paste text directly. Start with a small set of reliable sources rather than your whole site. Ten accurate pages teach the agent better than a hundred pages that include old blog posts and outdated offers.
After the content is added, review what the agent can see. Remove duplicate pages and anything you would not want quoted to a visitor. If two pages disagree, fix the pages first. The agent cannot resolve the contradiction for you.
Step 2: Set the Agent Instructions
Write a short instruction for the agent that states its role, its tone, and its limits. Keep it plain and specific. Tell it to answer only from the content you provided, to say when it does not know, and to offer a human contact when a question is outside its scope.
Test the instruction with real questions before you publish anything. Ask the agent about your opening hours, your refund policy, and a product you no longer sell. If it invents details, tighten the instruction and check the source content again. Testing in the dashboard is free and fast, so do it now rather than after visitors have seen the answers.
Step 3: Open Deploy and Copy the Code
When the agent answers well, open the Deploy section in the Chatbase dashboard. The Deploy menu offers several options, including a website widget, a website iframe, and WordPress. For a floating chat bubble, choose the website widget option. You may need to enable the chat bubble first. Copy the embed script exactly as provided and do not edit it. The script contains your agent ID, and changing it will break the connection.
While you are in the Deploy panel, look at the domain settings. Chatbase lets you restrict embedding to specific domains, so only your site can show the agent. Turn this on and add your domain. There is also an option to block direct access to the iframe link, which stops people from opening your agent in a browser tab on its own. Turn that on too if it is available on your plan.
Add the Code Safely in WordPress
There are three safe ways to add the code to your site. Pick one, and use only that one. Adding the same code twice can produce two chat bubbles and confuse visitors.
Method 1: Use the Official Chatbase Plugin
The simplest route is the official Chatbase plugin from the WordPress plugin directory. In your WordPress dashboard, go to Plugins, then Add New, and search for Chatbase. Install the plugin published by Chatbase and activate it. Then open the plugin settings, paste your agent ID into the designated field, and save.
The safest chatbase chatbot wordpress method is to paste the embed code through a code snippet plugin, not by editing theme files directly.
This method suits beginners. Keep the plugin updated, and check after each update that the bubble still appears.
Method 2: Use a Code Snippet Plugin
If you prefer the embed script, use a header and footer code plugin such as WPCode. Install and activate the plugin, then add a new snippet with your Chatbase script and set it to load in the footer on every page.
Paste the script exactly as copied from Chatbase. Do not add extra code around it, and do not paste it into a post or page content area. A script pasted into page content will usually be stripped out by the editor or shown as text to visitors.
Method 3: Use the Iframe for One Page
If you want the chat inside a single page rather than as a floating bubble, use the website iframe option from the Deploy menu. Copy the iframe code and paste it into a Custom HTML block on that page. The chat window appears inline, where you placed the block.
The iframe suits help pages, contact pages, and support hubs where visitors expect to chat in place. Give the block enough height so the chat window is usable. A short, squashed chat window is hard to read and hard to type in.
What Not to Do
Do not paste the script directly into your theme files, such as footer.php, unless you use a child theme. A parent theme update overwrites those files and removes your code without warning. Do not paste the script into a text widget or a page builder text block. And do not install both the plugin and the script. One method per site is the rule.
If you prefer a plugin instead of code, read our guide on how to add an AI chatbot to WordPress with a plugin.
A code snippet plugin from the official WordPress plugin directory keeps the embed code safe during theme updates.
Verify Frontend Display
After adding the code, check the live site. Open your homepage in a private or incognito browser window so you see the site as a visitor does. The chat bubble should appear in the corner you configured, usually lower right. Click it, type a test question, and confirm the agent replies with an answer drawn from your content.
After a chatbase chatbot wordpress install, open the site in a private browser window to confirm the widget appears for real visitors.
Test on a real phone as well. The bubble should not cover your mobile menu, cookie banner, or checkout button. Then check a second page, such as a product or services page, to confirm the bubble loads site-wide when that is what you intended.
Customize the Chatbase Widget
The chatbase widget wordpress display settings control how the bubble looks and what visitors see first. In the Chatbase dashboard, open the display settings for your agent. Set the bubble color to match your brand, add your business name, and write a short welcome message. One or two sentences is enough. Tell the visitor what the chat can help with, such as delivery questions or booking help, and what to expect if a human needs to follow up.
A finished chatbase chatbot wordpress setup should match your site colors and welcome message, so visitors trust the chat window.
Check the widget against your actual site colors. A bubble that matches your brand looks professional, while one that clashes draws the wrong kind of attention. Test the welcome message on desktop and mobile. Long greetings get skipped, and a message that promises instant human help when nobody is online will disappoint visitors.
Show the Bot on One Page Only
Can I show the bot on one page? Yes, and there are two clean ways to do it. The first is the iframe method. Instead of adding the site-wide script, paste the iframe code into a Custom HTML block on the one page where the chat should appear. The chat window then lives only on that page, inline with your content.
A chatbase chatbot wordpress embed can be limited to one page, which is useful when only your pricing page needs instant answers.
The second way is to limit the script to one page using your code snippet plugin. Most snippet plugins let you choose where a snippet loads, such as a single page or post. Set the Chatbase script to load only on that page, save, and verify in a private window that the bubble appears there and nowhere else.
Do not load the site-wide script and hide the bubble with CSS on other pages. Choose one method, place the code once, and check the result on the pages where the bot should and should not appear. Our guide on how to show a WordPress chatbot on selected pages covers display rules in more detail.
For the full method, see how to show a WordPress chatbot on selected pages.
Why the Widget Is Not Visible
Why is the widget not visible? The cause is usually simple. Work through these checks in order.
When a chatbase chatbot wordpress widget does not appear, the cause is usually a caching plugin or a display rule, not the embed code itself.
First, confirm the code is actually on the page. Open the page source in your browser and search for chatbase. If the script is missing, the snippet or plugin did not save, or it is set to load on different pages.
Second, clear your caches. Clear the WordPress caching plugin, the server cache, and your browser cache, then check the site in a private window. Caching is the most common reason a new widget seems invisible.
Third, check the domain settings in Chatbase. If you turned on the specific domains restriction, your site domain must be listed exactly. A missing www or a staging domain that differs from the live domain will block the widget.
Fourth, look for plugin conflicts. Temporarily deactivate other plugins, starting with other chat tools and security plugins that block third-party scripts. If the widget appears, you have found the conflict. Check the browser console for JavaScript errors too.
Finally, confirm the agent itself is active in Chatbase. If the agent is disabled or its deployment is paused, no code on your site will make it appear.
Limitations, Privacy, and Security
The agent answers from the content you provide. If that content is thin, outdated, or contradictory, the answers will be too. Review your source content regularly and re-test the agent after every major site update.
The agent can misunderstand questions, especially unusual phrasing or questions that combine two topics. It should be configured to say when it does not know and to direct the visitor to a human contact. Never let it promise refunds, approve discounts, or give advice about a specific order.
Chatbase is a third-party service. Visitor messages pass through its systems, so your privacy policy should explain that chats are handled by a third-party provider. Only ask visitors for the information you genuinely need, such as a name and an email address for follow-up.
Protect your Chatbase account with a strong, unique password and two-factor authentication if it is available. Keep your agent ID and any API keys private. The embed script itself is meant to be public on your site, but your account password and API keys are not. Restrict embedding to your own domains in the Deploy settings so other sites cannot show your agent.
Frequently Asked Questions
Can I show the bot on one page?
Yes. Use the website iframe option from the Deploy menu and paste the iframe code into a Custom HTML block on that page, or use your code snippet plugin to load the widget script only on that page. Both methods keep the chat off your other pages.
Why is the widget not visible?
The most common causes are a missing or misplaced script, a cache that has not cleared, a domain restriction that does not list your site, or a plugin conflict. Check the page source for the script, clear all caches, confirm your domain is listed in the Chatbase Deploy settings, and test with other plugins temporarily deactivated. Also confirm the agent is active in Chatbase.
Do I need a plugin to embed Chatbase?
No, but the official Chatbase plugin is the easiest route if you want to avoid code. You install it, paste your agent ID into the settings, and save. The alternative is pasting the embed script through a code snippet plugin such as WPCode, or using the iframe code in a Custom HTML block for a single page. All three methods work. Pick one and do not combine them.
Conclusion
To embed a Chatbase chatbot in WordPress, create the agent in Chatbase, train it on accurate content, copy the embed code from the Deploy menu, and add it to your site with the official plugin or a code snippet plugin. Then verify the widget on desktop and mobile and test it with real visitor questions before you rely on it.
Your next step is to open Chatbase, build your agent from your best FAQ and policy pages, and add it to a staging copy of your site first. Test the full conversation as a visitor would, fix the rough edges, and only then publish it live.