> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replybubble.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WordPress Plugin

> Install the ReplyBubble WordPress plugin to add your AI chatbot in one click

Add the ReplyBubble chat widget to your WordPress site with our official plugin. No code editing required.

> **Time estimate:** \~2 minutes

***

## Install the Plugin

### Step 1: Download

Download the ReplyBubble plugin from your dashboard:

1. Log in to your [ReplyBubble dashboard](https://app.replybubble.com)
2. Go to **Integrations → WordPress**
3. Click **Download Plugin** to save the `.zip` file

### Step 2: Upload to WordPress

1. In your WordPress admin, go to **Plugins → Add New**
2. Click **Upload Plugin** at the top of the page
3. Choose the `.zip` file you downloaded
4. Click **Install Now**
5. Click **Activate** once the installation finishes

### Step 3: Enter your Widget ID

1. Go to **Settings → ReplyBubble** in your WordPress admin
2. Copy your **Widget ID** from the [ReplyBubble dashboard](https://app.replybubble.com/integrations/wordpress)
3. Paste it into the **Widget ID** field
4. Click **Save Changes**

That's it — the chat widget will now appear on every page of your WordPress site.

***

## Plugin Settings

The plugin settings page (**Settings → ReplyBubble**) has two fields:

| Field          | Description                                        | Default                       |
| -------------- | -------------------------------------------------- | ----------------------------- |
| **Widget ID**  | Your unique widget identifier (starts with `rbw_`) | —                             |
| **Server URL** | The ReplyBubble server URL                         | `https://app.replybubble.com` |

> **Note:** Only change the Server URL if you are self-hosting ReplyBubble. The default value works for all standard accounts.

***

## How It Works

The plugin automatically adds the ReplyBubble embed script to every page of your site. It loads asynchronously, so it won't slow down your page.

The script tag it generates looks like this:

```html theme={null}
<script
  src="https://app.replybubble.com/widget/replybubble.js"
  data-widget-id="YOUR_WIDGET_ID"
  async
></script>
```

***

## Verifying Installation

After activating the plugin and entering your Widget ID:

1. Visit your WordPress site in a new browser tab (or hard-refresh with Ctrl+Shift+R)
2. Look for the chat bubble in the bottom-right corner
3. Click it and send a test message
4. Check your [ReplyBubble inbox](https://app.replybubble.com/conversations) to confirm the message arrived

***

## Alternative: Manual Installation

If you prefer not to use the plugin, you can add the embed snippet directly. See the [Widget Installation guide](/widget-installation#wordpress) for manual WordPress setup instructions.

***

## Uninstalling

1. Go to **Plugins** in your WordPress admin
2. Click **Deactivate** under ReplyBubble
3. Click **Delete** to remove the plugin

Your ReplyBubble account and conversation history are not affected by removing the plugin. You can reinstall at any time.

***

## Troubleshooting

### Widget doesn't appear after installing

* **Check your Widget ID** — make sure it matches the one shown in your [dashboard](https://app.replybubble.com/integrations/wordpress). It starts with `rbw_` followed by a random string, e.g., `rbw_Pi2DpP7ytgMObG0mbkzUuA`.
* **Clear your cache** — if you use a caching plugin (WP Super Cache, W3 Total Cache, etc.), clear the cache after activating the ReplyBubble plugin.
* **Check for conflicts** — temporarily switch to a default theme (like Twenty Twenty-Five) to rule out theme conflicts.
* **Check CSP headers** — if your site uses a Content Security Policy, allow `*.replybubble.com`. See [Troubleshooting](/troubleshooting) for details.

### Plugin settings page is missing

Make sure the plugin is activated. Go to **Plugins** and verify "ReplyBubble" shows as **Active**.

### Need more help?

Visit our [Troubleshooting guide](/troubleshooting) or reach out through the chat widget on [replybubble.com](https://replybubble.com).