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

# Wordpress

Connect WordPress for content publishing, AI crawler analytics, and index submissions

**Status:** Available | **Complexity:** Beginner | **Setup time:** 10-15 minutes

The WordPress integration allows you to publish content directly from ChatFeatured, track AI crawler activity on your WordPress site, and automatically submit new URLs to search engines.

<Warning>
  **Install the plugin on your production site, not your staging site.**

  Agent Analytics and Index Submissions only generate useful data from the WordPress instance that real visitors and AI crawlers actually hit. If you install the plugin on a staging or local site:

  * **Agent Analytics** will see little to no AI crawler traffic, because bots like GPTBot, ClaudeBot, and PerplexityBot crawl your live domain
  * **Index Submissions** will submit staging URLs (which usually aren't indexable) instead of your real pages

  **Prefer not to publish directly to production?** You don't have to. Open any article in ChatFeatured and use the **Export** menu in the top-right to:

  * **Copy HTML**, **Copy Rich Text**, or **Copy Markdown** — paste into the WordPress editor manually
  * **Download DOCX** — import via a WordPress DOCX import plugin or your editorial workflow

  This way you still get Agent Analytics and Index Submissions on your production site without giving ChatFeatured publish access.
</Warning>

## Features

<CardGroup cols={3}>
  <Card title="Content Publishing" icon="pen-to-square">
    Publish content created in ChatFeatured directly to WordPress with full control over post status, categories, and featured images.
  </Card>

  <Card title="Agent Analytics" icon="robot">
    Track which AI bots (GPTBot, ClaudeBot, etc.) are crawling your site and which pages they're accessing.
  </Card>

  <Card title="Index Submissions" icon="magnifying-glass">
    Automatically submit new and updated URLs to search engines for faster discovery.
  </Card>
</CardGroup>

## Setup Requirements

* WordPress 5.0 or higher
* Administrator access to your WordPress site
* PHP 7.4 or higher

## Installation & Connection

### Step 1: Download the Plugin

1. Log in to ChatFeatured
2. Go to **Integrations** → **WordPress**
3. Click **Download Plugin** to get `chatfeatured-wordpress.zip`

### Step 2: Install on WordPress

1. Log in to your WordPress admin dashboard at `yourdomain.com/wp-admin`
2. Go to **Plugins** → **Add New** → **Upload Plugin**
3. Click "Choose File" and select the downloaded zip file
4. Click **Install Now**, then **Activate**

<Tip>
  After activation, you'll see a new **ChatFeatured** menu item in your WordPress admin sidebar.
</Tip>

### Step 3: Generate API Token

1. In WordPress admin, go to **ChatFeatured** → **Publishing**
2. Click **Generate New Token**
3. Copy the generated token (it starts with `cf_`)

<Warning>
  Keep this token secure—it grants publish access to your WordPress site. You can regenerate it at any time if compromised.
</Warning>

### Step 4: Connect in ChatFeatured

1. In ChatFeatured, go to **Integrations** → **WordPress**
2. Enter your WordPress site URL (e.g., `https://yourblog.com`)
3. Paste the API token you copied from WordPress
4. Click **Connect WordPress**

Once connected, you'll see a "Connected" status and can enable the features you want to use.

***

## Enabling Features

After connecting WordPress, toggle each feature on the WordPress integration page:

### Content Publishing

Publish content directly from ChatFeatured to WordPress:

1. Enable the **Publishing** toggle
2. Create content (manually or with the [Content Agent](/ai-agents/content-agent))
3. Click **Publish to WordPress**
4. Configure post settings:
   * **Status**: Draft, Publish, or Scheduled
   * **Categories**: Select or create categories
   * **Tags**: Add relevant tags
   * **Author**: Map to a WordPress user
   * **Featured Image**: Upload or provide URL
5. Click **Publish**

**Post Status Options:**

| Status    | Description                           |
| --------- | ------------------------------------- |
| Draft     | Saved but not visible to visitors     |
| Publish   | Live on your site immediately         |
| Scheduled | Will publish at a specified date/time |

### Agent Analytics

Track which AI bots are crawling your WordPress site:

1. Enable the **Agent Analytics** toggle
2. The plugin automatically captures HTTP request logs from your site
3. AI crawler visits flow to ChatFeatured for analysis
4. View analytics in your **Agent Analytics** dashboard

**AI Bots Tracked:**

* **GPTBot** (OpenAI/ChatGPT)
* **ClaudeBot** (Anthropic/Claude)
* **Google-Extended** (Google AI)
* **PerplexityBot** (Perplexity)
* **Googlebot** and other crawlers

<Info>
  The plugin is designed for minimal performance impact with queue-based batch sending and automatic filtering of admin pages and static assets.
</Info>

### Index Submissions

Automatically submit new and updated URLs to search engines for faster indexing:

1. Enable the **Index Submissions** toggle
2. The plugin automatically submits URLs when you publish or update posts
3. View submission history in your **Index Submissions** dashboard

<Note>
  Index Submissions requires verification. After enabling, you may see a "Pending Verification" status while the key is verified with your site.
</Note>

***

## Best Practices

### Content Publishing

* Test with draft posts first before publishing live
* Set up appropriate author mappings
* Use categories and tags consistently
* Review posts in WordPress after publishing

### Agent Analytics

* Enable analytics before making major content changes
* Use data to understand which content AI models access
* Correlate crawler activity with visibility improvements

### Index Submissions

* Enable for all sites where you want faster search engine indexing
* Works automatically when you publish or update posts
* Monitor the Index Submissions dashboard to verify URLs are being submitted

***

## Troubleshooting

<Accordion title="Connection Issues: 'Could not connect to WordPress'">
  **Solutions:**

  1. Verify the WordPress URL is correct (include `https://`)
  2. Check that the ChatFeatured plugin is activated in WordPress
  3. Ensure the API token is correct (should start with `cf_`)
  4. Verify your site is publicly accessible
</Accordion>

<Accordion title="Connection Issues: 'Authentication failed'">
  **Solutions:**

  1. Go to **ChatFeatured** → **Publishing** in WordPress
  2. Generate a new API token
  3. Update the token in ChatFeatured and reconnect
</Accordion>

<Accordion title="Publishing Issues: 'Failed to create post'">
  **Solutions:**

  1. Check that the WordPress user has publish permissions
  2. Verify the Publishing feature is enabled (toggle on)
  3. Check WordPress error logs for details
</Accordion>

<Accordion title="Publishing Issues: 'Featured image not appearing'">
  **Solutions:**

  1. Ensure the image URL is publicly accessible
  2. Check that the image format is supported (JPG, PNG, GIF, WebP)
  3. Verify WordPress has write permissions to the uploads directory
</Accordion>

<Accordion title="Analytics Issues: 'No crawler data appearing'">
  **Solutions:**

  1. Verify the Agent Analytics toggle is enabled
  2. Allow 24-48 hours for data to accumulate
  3. Crawler visits depend on your site's visibility to AI bots
  4. Check that your site isn't blocking bot traffic
</Accordion>

<Accordion title="Index Submissions: 'Pending verification' status">
  **Solutions:**

  1. The key file needs to be accessible at your site root
  2. The plugin should create this automatically—check if it exists
  3. Try disabling and re-enabling Index Submissions
</Accordion>

***

## Advanced Setup

### WP-CLI Commands

For advanced users, the plugin includes WP-CLI commands:

```bash theme={null}
# Show plugin status
wp chatfeatured status

# Process the analytics queue manually
wp chatfeatured process-queue

# Send a test event
wp chatfeatured test-event

# Generate a new publishing token
wp chatfeatured generate-token

# Clear the analytics queue
wp chatfeatured clear-queue --yes
```

### Plugin Permissions

The plugin requires:

* Read/write access to posts
* Access to categories and tags
* Media upload permissions
* Ability to log HTTP requests (for Agent Analytics)

These are standard WordPress capabilities for content management.

***

## Security & Best Practices

### API Token Security

* Treat your API token like a password (it starts with `cf_`)
* Regenerate tokens if compromised
* The token grants publish access to your WordPress site
* Create separate tokens for different integrations

### Data Privacy

* Only request metadata is logged (no page content or user data)
* ChatFeatured is GDPR compliant
* All data transmitted over HTTPS

***

## See Also

* [Agent Analytics](/using-chatfeatured/agent-analytics) — Understanding AI crawler activity
* [Index Submissions](/index-submissions/index-submissions) — AI search engine submission
* [Content Agent](/ai-agents/content-agent) — Automated content creation