# Install the Convo AI Chat Widget on WordPress

> Copy the Convo AI embed code from the dashboard and add it to your WordPress site header with a code-snippet plugin or your theme. Works with any WordPress theme.

Source: https://edesy.in/docs/wordpress/install

The Convo AI widget is one script tag. Add it to the `<head>` of your WordPress site and the chat bubble appears on every page.

## Step 1: Get your embed code

1. Sign in to [Convo AI](https://convo.edesy.in).
2. Open **Engage → Chat Widgets**.
3. Set your **Widget Name** and **Website Domain**, then save the widget. Saving creates the widget's API key.
4. In the **Embed Code** card ("Add this code to your website"), click copy.

The code looks like this. Always copy yours from the dashboard, because it contains your own API key and server address:

```html
<!-- ConvoAI Chat Widget SDK -->
<script src="YOUR_SDK_URL/convoai-chat.js" data-api-key="YOUR_API_KEY" data-base-url="YOUR_BASE_URL" async></script>
```

## Step 2: Add the code to WordPress

Pick one of these methods. You only need one.

### Option A: A header and footer code plugin (recommended)

This keeps the code in place when you change or update your theme.

1. In WordPress, go to **Plugins → Add New**.
2. Install and activate a plugin that adds code to the site header, such as WPCode or Insert Headers and Footers.
3. Open the plugin's header settings, paste the embed code into the **Header** box and save.

### Option B: Your theme's header file

Use this only with a child theme, because a theme update replaces `header.php`.

1. Go to **Appearance → Theme File Editor** and open `header.php` of your child theme.
2. Paste the embed code just before the closing `</head>` tag.
3. Click **Update File**.

### Option C: Your theme's custom code setting

Many themes and page builders have a field for header scripts (often under the theme options or **Customize**). Paste the embed code there and save.

## Step 3: Check the widget

1. Open your site in a private browser window.
2. The chat bubble appears in the position set in **Engage → Chat Widgets**.
3. Send a test message. It shows up in the Convo AI **Inbox**.

If you use a caching or optimisation plugin, clear its cache after adding the code. If the bubble does not appear, see [Troubleshooting](https://edesy.in/docs/wordpress/troubleshooting).

## Customise the widget

Change these in **Engage → Chat Widgets**, with no WordPress edits:

| Tab | Settings |
|---|---|
| Appearance | Primary and secondary colour, widget position, light, dark or auto colour scheme, widget size |
| Messages | Greeting message, offline message, suggested questions, auto-open and its delay |
| Identity | Ask for name, email and phone: off, optional or required |
| Hours | Business hours and timezone |
| Advanced | Show agent typing, widget active on or off |

## Next step

Selling with WooCommerce? [Connect your store](https://edesy.in/docs/wordpress/install/woocommerce) so conversations can use order and customer data.