# WordPress

Add your AI agent to a WordPress site with the QwryAI plugin and your Agent ID

## Overview

WordPress doesn't need embed code. Install the QwryAI plugin from the WordPress plugin directory, paste your Agent ID into its settings, and the plugin adds the chat bubble to every page of your site.

### What you can do

Answer visitors' questions on your WordPress site from a chat bubble, without editing your theme.

## Before you start

- A QwryAI account with an AI agent
- A WordPress site (6.0 or later) where you can install plugins. WordPress.com sites need a plan that allows plugins.

## How to add your AI agent to WordPress

#### 1. Install the QwryAI plugin

1. Sign in to your WordPress admin. It's usually at yoursite.com/wp-admin.
2. Go to Plugins → Add Plugin. Older WordPress versions call it Add New Plugin.
3. Search for QwryAI.
4. Click Install Now on the QwryAI plugin, then click Activate.

![WordPress Add Plugins page with the QwryAI plugin found by searching for QwryAI](/docs/screenshots/original/qwryai-wordpress-install.png)

Search for QwryAI on the Add Plugins page, then install and activate it.

#### 2. Copy your Agent ID

1. In QwryAI, open the AI agent you want on your site.
2. Click Channels in the sidebar, then click Manage on the Chat bubble card.
3. Click Deploy and choose WordPress.
4. Next to Agent ID, click Copy.

![The Add to WordPress dialog in QwryAI with the Agent ID and its Copy button](/docs/screenshots/original/qwryai-deploy-wordpress.png)

Deploy → WordPress shows your Agent ID, ready to copy.

#### 3. Paste it into WordPress

1. In WordPress admin, go to Settings → QwryAI Options.
2. Paste your Agent ID into the Agent ID field.
3. Click Save Changes.

![WordPress QwryAI Plugin Settings page with an Agent ID saved](/docs/screenshots/original/qwryai-wordpress-settings.png)

Settings → QwryAI Options after the Agent ID is saved.

> **Manual upload**: Can't install from the plugin directory? In Deploy → WordPress, click Download plugin (.zip). Then upload the file in WordPress under Plugins → Add Plugin → Upload Plugin.

## Check it works

Open your site in a new browser window, open the chat bubble, and ask a question your agent should know. The conversation appears in your QwryAI Inbox.

![A WordPress site with the QwryAI chat bubble and its greeting in the bottom-right corner](/docs/screenshots/original/qwryai-wordpress-live.png)

The chat bubble appears on every page once the Agent ID is saved.

> **Specific domains**: If Specific domains is on under Deploy, your site's address must be on its list. Add it, for example example.com, and click Save domains.

> To change the chat bubble's colors, text, and position, open Channels → Chat bubble → Display in QwryAI. Your site picks up the changes without touching WordPress.

## Troubleshooting

### WordPress says the Agent ID doesn't look right

Copy it again with the Copy button in Deploy → WordPress, and paste it without extra spaces or line breaks.

### The chat bubble doesn't show on the site

Check that the QwryAI plugin is active and the Agent ID is saved. If your site uses a caching plugin or a host cache, clear it, then reload the page.

## Next steps

- [Channels: customize the chat bubble](/docs/user-guides/agent-management/channels)
- [Website platforms: every way to add QwryAI to a site](/docs/user-guides/integrations/website-platforms)
