> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thinnest.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# WordPress
> Add your thinnestAI agent to any WordPress site with a simple plugin or embed code.
# WordPress
Add your AI agent to your WordPress site. Works with any WordPress theme — classic editor, block editor, or page builders like Elementor and Divi.
## Method 1: Embed Code (Recommended)
The simplest approach — paste the embed script into your WordPress site.
### Option A: Site-Wide (Header/Footer)
Add the widget to every page on your site:
1. In WordPress admin, go to **Appearance > Theme Editor** (or **Customize > Additional CSS/JS**)
2. Or install a plugin like **Insert Headers and Footers**
3. Add this code to your site's `` or footer:
```html theme={null}
```
4. Save and visit your site — the chat bubble should appear
### Option B: Specific Pages Only
Add the widget to individual pages or posts:
1. Edit the page or post
2. Add a **Custom HTML** block (block editor) or switch to **Text** mode (classic editor)
3. Paste the embed code
4. Publish or update the page
### Option C: Elementor
1. Edit your page with Elementor
2. Add an **HTML** widget
3. Paste the embed code
4. Save
### Option D: Divi
1. Edit your page with Divi Builder
2. Add a **Code** module
3. Paste the embed code
4. Save
## Method 2: Custom Plugin
For more control, create a simple WordPress plugin:
### Create the Plugin
1. Connect to your WordPress site via FTP or file manager
2. Navigate to `/wp-content/plugins/`
3. Create a folder: `thinnestai-chat`
4. Create a file `thinnestai-chat.php`:
```php theme={null}
Settings saved.
';
}
$agent_id = get_option('thinnestai_agent_id', '');
?>
Installed Plugins**
6. Go to **Settings > thinnestAI** and enter your Agent ID
## Configuration
All [widget configuration options](/docs/deploy/web-widget#configuration-options) work in WordPress. Add `data-` attributes to the script tag:
```html theme={null}
```
## Lead Capture
Lead capture works the same as the standard [web widget](/docs/deploy/web-widget#lead-capture). Configure the lead form in your agent's Deploy settings — it will appear in the WordPress widget automatically.
## WooCommerce Integration
For WooCommerce stores, you can pass product context to your agent:
```html theme={null}
```
Your agent's knowledge base can include your product catalog (via URL scraping or file upload) so it can answer product questions accurately.
## Performance
The embed script is:
* **Async loaded** — Does not block page rendering
* **Lightweight** — \~15KB gzipped
* **Lazy initialized** — Widget UI only loads when the user clicks the bubble
* **CDN delivered** — Fast loading worldwide
No impact on your WordPress site's PageSpeed score.
## Troubleshooting
| Issue | Solution |
| ---------------------------- | ------------------------------------------------------ |
| Widget doesn't appear | Check for JavaScript errors in browser console |
| Conflicts with other plugins | Try loading the script in the footer instead of header |
| Caching issues | Clear your WordPress cache and CDN cache |
| CSP errors | Add `app.thinnest.ai` to your Content Security Policy |
| Widget overlaps content | Adjust `data-position` or add custom CSS margin |