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

# WordPress Integration

> Install the GrowthOS AI Traffic Analytics plugin to monitor how AI agents crawl and reference your WordPress site content.

## WordPress Plugin Integration

Connect GrowthOS AI Traffic Analytics to your WordPress site using our dedicated plugin to track AI agent interactions with your content, posts, and pages.

<Info>
  Our WordPress plugin works with any WordPress hosting provider and is compatible with WordPress 5.0+ and all major themes.
</Info>

## Prerequisites

Before installing the plugin, ensure you have:

* An active GrowthOS account
* WordPress admin access
* WordPress 5.0 or higher
* PHP 7.4 or higher
* Your website domain verified in GrowthOS

## Installation Methods

Choose your preferred installation method:

<Tabs>
  <Tab title="WordPress Admin (Recommended)">
    Install directly from your WordPress dashboard for the easiest setup.
  </Tab>

  <Tab title="Manual Upload">
    Download and upload the plugin files manually if needed.
  </Tab>

  <Tab title="WP-CLI">
    Use command line installation for developer workflows.
  </Tab>
</Tabs>

### Method 1: WordPress Admin Installation

<Steps>
  <Step title="Access WordPress Admin">
    1. Log in to your WordPress admin dashboard
    2. Navigate to **Plugins → Add New**
  </Step>

  <Step title="Search for GrowthOS">
    1. In the search bar, type "GrowthOS AI Traffic Analytics"
    2. Click **Search Plugins**

    <Tip>
      Look for the official plugin by GrowthOS with our verified badge.
    </Tip>
  </Step>

  <Step title="Install the plugin">
    1. Click **Install Now** on the GrowthOS AI Traffic Analytics plugin
    2. Wait for installation to complete
    3. Click **Activate** to enable the plugin
  </Step>

  <Step title="Configure plugin settings">
    1. Go to **Settings → GrowthOS Analytics**
    2. Enter your GrowthOS API key
    3. Verify your domain connection

    <Warning>
      You'll need your API key from your GrowthOS dashboard. Find it under **Settings → API Keys**.
    </Warning>
  </Step>
</Steps>

### Method 2: Manual Upload

<Steps>
  <Step title="Download plugin">
    1. Log in to your GrowthOS dashboard
    2. Go to **Integrations → WordPress**
    3. Download the plugin ZIP file
  </Step>

  <Step title="Upload to WordPress">
    1. In WordPress admin, go to **Plugins → Add New**
    2. Click **Upload Plugin**
    3. Choose the downloaded ZIP file
    4. Click **Install Now**
  </Step>

  <Step title="Activate and configure">
    1. Click **Activate Plugin**
    2. Navigate to **Settings → GrowthOS Analytics**
    3. Enter your API key and configure settings
  </Step>
</Steps>

### Method 3: WP-CLI Installation

<CodeGroup>
  ```bash Install Plugin theme={null}
  wp plugin install growthos-ai-analytics --activate
  ```

  ```bash Configure Settings theme={null}
  wp option update growthos_api_key 'your-api-key-here'
  wp option update growthos_domain_verified true
  ```
</CodeGroup>

## Plugin Configuration

Once installed, configure the plugin for optimal AI traffic monitoring:

<Steps>
  <Step title="API Key Setup">
    1. Navigate to **Settings → GrowthOS Analytics**
    2. Enter your API key from your GrowthOS dashboard
    3. Click **Verify Connection**

    <Check>
      A green checkmark confirms successful API connection.
    </Check>
  </Step>

  <Step title="Monitoring Settings">
    Configure what to track:

    * **All Pages**: Monitor entire site
    * **Posts Only**: Focus on blog content
    * **Custom Post Types**: Include products, portfolios, etc.
    * **Admin Pages**: Usually disabled for privacy
  </Step>

  <Step title="AI Agent Detection">
    Enable detection for specific AI crawlers:

    * GPTBot (ChatGPT)
    * GoogleBot-AI (Bard/Gemini)
    * Claude-Web (Claude)
    * PerplexityBot
    * Custom AI agents
  </Step>

  <Step title="Privacy Settings">
    Configure data collection preferences:

    * **Anonymous Tracking**: No personal data collected
    * **Aggregate Data Only**: Site-level insights only
    * **Detailed Logging**: Full request analysis (recommended)
  </Step>
</Steps>

## Advanced Configuration

### Custom Post Types

<Accordion title="Monitor WooCommerce products">
  ```php theme={null}
  // Add to functions.php or custom plugin
  add_filter('growthos_track_post_types', function($post_types) {
      $post_types[] = 'product';
      return $post_types;
  });
  ```
</Accordion>

<Accordion title="Exclude specific pages">
  ```php theme={null}
  // Exclude certain pages from tracking
  add_filter('growthos_exclude_pages', function($excluded) {
      $excluded[] = get_option('page_for_posts'); // Blog page
      $excluded[] = 123; // Specific page ID
      return $excluded;
  });
  ```
</Accordion>

<Accordion title="Custom AI agent detection">
  ```php theme={null}
  // Add custom AI user agents
  add_filter('growthos_ai_agents', function($agents) {
      $agents['CustomBot'] = 'Custom-AI-Agent';
      return $agents;
  });
  ```
</Accordion>

## What You'll Monitor

The WordPress plugin tracks comprehensive AI agent interactions:

<CardGroup cols={2}>
  <Card title="Page Crawl Frequency" icon="chart-line">
    See how often AI agents visit each post, page, and custom post type.
  </Card>

  <Card title="Content Performance" icon="star">
    Identify which content AI agents reference most in their responses.
  </Card>

  <Card title="SEO Impact" icon="magnifying-glass">
    Monitor how AI crawling affects your search engine optimization.
  </Card>

  <Card title="Site Speed Impact" icon="clock">
    Track if AI agents affect your WordPress site's performance.
  </Card>
</CardGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Plugin not tracking data">
    **Common solutions:**

    * Verify API key is entered correctly
    * Check that your domain is verified in GrowthOS
    * Ensure WordPress site is publicly accessible
    * Confirm no caching plugins are interfering
  </Accordion>

  <Accordion title="High server resource usage">
    **Optimization tips:**

    * Enable "Aggregate Data Only" mode
    * Limit tracking to specific post types
    * Exclude admin and private pages
    * Use caching for API requests
  </Accordion>

  <Accordion title="Conflicts with other plugins">
    **Check compatibility with:**

    * Security plugins (may block AI agents)
    * Caching plugins (can interfere with tracking)
    * Analytics plugins (potential data conflicts)
    * SEO plugins (robots.txt modifications)
  </Accordion>
</AccordionGroup>

## WordPress-Specific Benefits

<Tip>
  **Content Strategy Insights**: See which blog posts and pages AI agents find most valuable for answering user questions.
</Tip>

<Check>
  **WooCommerce Integration**: Track how AI agents discover and reference your product pages and descriptions.
</Check>

<Warning>
  **SEO Optimization**: Identify content gaps where AI agents can't find relevant information on your site.
</Warning>

## Plugin Updates

<Steps>
  <Step title="Automatic updates">
    Enable automatic updates in WordPress admin for the latest AI detection features.
  </Step>

  <Step title="Manual updates">
    Check **Plugins → Installed Plugins** regularly for available updates.
  </Step>

  <Step title="Update notifications">
    Configure email notifications for plugin updates in GrowthOS dashboard.
  </Step>
</Steps>

## Next Steps

<CardGroup cols={2}>
  <Card title="Optimize Content" icon="pen-to-square" href="/essentials/optimization">
    Use AI traffic data to improve your WordPress content strategy.
  </Card>

  <Card title="WooCommerce Guide" icon="shopping-cart" href="/integrations/woocommerce">
    Specific setup for e-commerce AI traffic monitoring.
  </Card>
</CardGroup>

<Note>
  Need help with WordPress integration? Contact our support team at [support@growth-os.co](mailto:support@growth-os.co) or check our [WordPress-specific documentation](https://docs.growth-os.co/wordpress).
</Note>