> ## Documentation Index
> Fetch the complete documentation index at: https://docs.convocore.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# WordPress
> Integrate your Convocore Agent into your WordPress website.
Before you begin, make sure you have:
A Convocore account with a configured AI agent
Admin access to your WordPress website
## Integration Methods
There are three main ways to integrate your Convocore Agent widget into WordPress:
Using the "Insert Headers and Footers" plugin
Directly editing your theme's header.php file
Using Elementor's Custom Code feature
## Convocore Agent Widget Code
Before proceeding with any method, you'll need your Convocore Agent widget code:
```html theme={null}
```
Remember to replace **YOUR\_AGENT\_ID** with your actual Convocore Agent ID.
## Method 1: Using a Plugin
1. Open your `WordPress` dashboard
2. Go to **Plugins** > **Add New**
3. Search for **Insert Headers and Footers**
4. Install and activate the plugin by **WPBrigade**
Go to **Settings** > **WP Headers and Footers** in the sidebar
Paste the Convocore Agent widget code in the header section
Click **Save Changes**
## Method 2: Using the Theme Editor
Editing theme files directly can break your site if not done correctly. Always backup your site before making changes.
1. Open your `WordPress` dashboard
2. Go to **Appearance** > **Theme File Editor**
1. In the `Theme Files` section on the right, find and open the **header.php** file
2. Locate the closing `` tag
Paste the Convocore widget code just before the closing `` tag
Click **Update File** to save your changes
## Method 3: Using Elementor
1. Login to WP Admin
2. Go to **Elementor** > **Custom Code**
Click **Add New Custom Code**
1. Enter a **title** for your code snippet
2. Choose the **Location**:
* `` for page level
* `` - Start for beginning of the page's body
* `` - End for end of the page's body
3. Set the **Priority** (1-10, lower numbers have higher priority)
4. Paste the Convocore widget code in the code block editor
1. In the **Publish** block, click **Edit** next to **Conditions**
2. Set the desired conditions for where the widget should appear
Click **Publish** to make your changes live
### Customization Options
You can customize your widget's behavior and appearance by adjusting the VG\_CONFIG options:
Modify the `render` option to 'bottom-left' or 'bottom-right' to change the widget's position.
Add `autostart: true,` to the `VG_CONFIG` object to have the widget open automatically when a user visits your website.
Add your own CSS file to the `stylesheets` array for custom styling:
```
javascript
stylesheets: [
"https://vg-bunny-cdn.b-cdn.net/vg_live_build/styles.css",
"https://your-custom-css-url.css"
],
```
## Troubleshooting
**If you encounter issues with your Convocore widget integration:**
1. Verify that you've copied the entire code snippet correctly.
2. Double-check that you've replaced "YOUR\_AGENT\_ID" with your actual Convocore Agent ID.
3. Clear your browser cache and refresh your WordPress website to see changes.
4. If using a caching plugin, clear the cache after making changes.
5. Check for conflicts with other plugins or theme customizations.
If you're using a security plugin, make sure it's not blocking the Convocore scripts from loading.