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

# Configuration Guide

> Complete configuration guide for the LLMTAG WordPress plugin

## Configuration Overview

The LLMTAG plugin provides extensive configuration options to customize AI protection for your specific needs. This guide covers all available settings and their recommended configurations.

## Accessing Configuration

Navigate to **LLMTAG > Settings** in your WordPress admin dashboard to access all configuration options.

<Info>
  Configuration changes are applied immediately. No need to save or restart the plugin.
</Info>

## Core Settings

### General Settings

#### Protection Mode

Choose the level of AI protection for your website:

<Tabs>
  <Tab title="Basic Mode">
    **Features:**

    * llmtag.txt file generation
    * Basic AI policy declaration
    * No active blocking

    **Best for:** Personal blogs, simple websites

    ```txt theme={null}
    # Generated llmtag.txt
    spec_version: 3.0
    ai_training_data: disallow
    ai_use: search_indexing
    ```
  </Tab>

  <Tab title="Standard Mode">
    **Features:**

    * llmtag.txt file generation
    * AI agent blocking (60+ agents)
    * Basic analytics

    **Best for:** Business websites, content sites

    ```txt theme={null}
    # Generated llmtag.txt
    spec_version: 3.0
    ai_training_data: disallow
    ai_use: search_indexing, generative_synthesis
    ```
  </Tab>

  <Tab title="Advanced Mode">
    **Features:**

    * Full llmtag.txt customization
    * Advanced AI agent blocking
    * Comprehensive analytics
    * Custom rules and exceptions
    * Developer API access

    **Best for:** Enterprise sites, high-traffic websites
  </Tab>
</Tabs>

#### AI Training Data Policy

Control whether your content can be used for AI training:

<Columns cols={2}>
  <Card title="Allow" icon="check">
    **Use when:** You want to help AI models learn from your content

    **Examples:** Educational sites, open source documentation, research content
  </Card>

  <Card title="Disallow" icon="x">
    **Use when:** You want to protect your content from AI training

    **Examples:** Premium content, proprietary information, creative works
  </Card>
</Columns>

#### AI Use Permissions

Specify which AI applications are allowed:

<Checklist>
  <CheckboxItem>**Search Indexing** - Traditional search engine indexing</CheckboxItem>
  <CheckboxItem>**Generative Synthesis** - AI-generated answers and summaries</CheckboxItem>
  <CheckboxItem>**Commercial Products** - Use in paid AI features</CheckboxItem>
  <CheckboxItem>**Research** - Academic and non-commercial research</CheckboxItem>
  <CheckboxItem>**Personal Assistance** - Personal AI assistants and chatbots</CheckboxItem>
</Checklist>

## AI Agent Management

### Blocked Agents

The plugin maintains a database of 60+ known AI agents and crawlers:

#### Categories

<Columns cols={2}>
  <Card title="OpenAI Agents" icon="robot">
    * GPTBot
    * ChatGPT-User
    * OpenAI-Web
  </Card>

  <Card title="Google AI" icon="google">
    * Google-Extended
    * Bard-Web
    * Gemini-Crawler
  </Card>

  <Card title="Anthropic" icon="brain">
    * Claude-Web
    * Anthropic-Bot
  </Card>

  <Card title="Other AI Services" icon="cloud">
    * PerplexityBot
    * Copilot-Web
    * AI-Writing-Tools
  </Card>
</Columns>

#### Agent Selection

Choose which agents to block:

<Steps>
  <Step title="Select Categories">
    Use category checkboxes to block entire groups of AI agents at once.
  </Step>

  <Step title="Individual Agents">
    Fine-tune by selecting or deselecting specific agents within categories.
  </Step>

  <Step title="Custom Agents">
    Add custom user-agent strings for agents not in the database.
  </Step>

  <Step title="Whitelist Exceptions">
    Create exceptions for specific agents you want to allow.
  </Step>
</Steps>

### Agent-Specific Rules

Set different policies for different AI agents:

```txt theme={null}
# Example: Allow research bots but block commercial AI
User-agent: ResearchBot
ai_training_data: allow
ai_use: research

User-agent: CommercialAI
ai_training_data: disallow
ai_use: search_indexing
```

## Content Protection

### Path-Based Protection

Apply different policies to different sections of your website:

#### Protected Paths

<Columns cols={2}>
  <Card title="Premium Content" icon="lock">
    **Path:** `/premium/`
    **Policy:** Block all AI training and commercial use
  </Card>

  <Card title="User Content" icon="users">
    **Path:** `/user-content/`
    **Policy:** Block AI training, allow search indexing
  </Card>

  <Card title="Private Areas" icon="eye-slash">
    **Path:** `/private/`
    **Policy:** Block all AI access
  </Card>

  <Card title="Public Resources" icon="globe">
    **Path:** `/public/`
    **Policy:** Allow all AI use
  </Card>
</Columns>

#### Path Configuration

<Steps>
  <Step title="Add Protected Path">
    Enter the path pattern (e.g., `/premium/`, `/user-content/`)
  </Step>

  <Step title="Set Protection Level">
    Choose the protection level for this path:

    * **Full Protection**: Block all AI access
    * **Training Block**: Block AI training only
    * **Custom Rules**: Set specific policies
  </Step>

  <Step title="Configure Exceptions">
    Add exceptions for specific agents or use cases
  </Step>

  <Step title="Test Configuration">
    Verify the path protection is working correctly
  </Step>
</Steps>

### Post-Type Protection

Apply different policies to different WordPress post types:

<Tabs>
  <Tab title="Posts">
    **Default:** Follow global policy
    **Custom:** Set specific AI policies for blog posts
  </Tab>

  <Tab title="Pages">
    **Default:** Follow global policy
    **Custom:** Set specific AI policies for static pages
  </Tab>

  <Tab title="Custom Post Types">
    **Default:** Follow global policy
    **Custom:** Set specific AI policies for custom content types
  </Tab>

  <Tab title="Media">
    **Default:** Follow global policy
    **Custom:** Set specific AI policies for images and files
  </Tab>
</Tabs>

## Advanced Configuration

### Custom Rules

Create custom llmtag.txt rules for specific scenarios:

#### Rule Builder

<Steps>
  <Step title="Select Scope">
    Choose the scope for your rule:

    * **Global**: Applies to entire site
    * **Path**: Applies to specific paths
    * **Agent**: Applies to specific AI agents
    * **Combined**: Applies to specific agents on specific paths
  </Step>

  <Step title="Set Conditions">
    Define the conditions for your rule:

    * **User Agent**: Specific AI agent
    * **Path Pattern**: URL path pattern
    * **Content Type**: WordPress post type
    * **Date Range**: Time-based rules
  </Step>

  <Step title="Define Actions">
    Set the actions for your rule:

    * **AI Training**: Allow or disallow
    * **AI Use**: Specify allowed use cases
    * **Blocking**: Block or allow the agent
    * **Custom**: Add custom directives
  </Step>

  <Step title="Test and Deploy">
    Test your rule and deploy it to production
  </Step>
</Steps>

#### Custom Directives

Add custom directives to your llmtag.txt file:

```txt theme={null}
# Custom verification challenge
verification_challenge: sha256:your_custom_hash_here

# Custom metadata
ai_industry: technology
ai_purpose: educational
ai_license: creative-commons
```

### Performance Settings

#### Caching Configuration

<Columns cols={2}>
  <Card title="llmtag.txt Caching" icon="clock">
    **Enable:** Cache the llmtag.txt file for better performance
    **Duration:** 1 hour (recommended)
    **Clear:** Automatically clear on policy changes
  </Card>

  <Card title="Agent Database Caching" icon="database">
    **Enable:** Cache AI agent database for faster lookups
    **Duration:** 24 hours (recommended)
    **Update:** Automatic daily updates
  </Card>
</Columns>

#### Resource Optimization

<Steps>
  <Step title="Database Optimization">
    Enable database query optimization for analytics
  </Step>

  <Step title="Memory Management">
    Set memory limits for large-scale blocking operations
  </Step>

  <Step title="Log Rotation">
    Configure log file rotation to prevent disk space issues
  </Step>

  <Step title="Background Processing">
    Enable background processing for heavy operations
  </Step>
</Steps>

## Analytics Configuration

### Data Collection

Configure what data to collect and how long to keep it:

#### Collection Settings

<Checklist>
  <CheckboxItem>**Blocked Requests** - Track blocked AI agent requests</CheckboxItem>
  <CheckboxItem>**Agent Activity** - Monitor AI agent access patterns</CheckboxItem>
  <CheckboxItem>**Policy Compliance** - Track compliance with your policies</CheckboxItem>
  <CheckboxItem>**Performance Metrics** - Monitor plugin performance impact</CheckboxItem>
</Checklist>

#### Data Retention

<Columns cols={2}>
  <Card title="Real-time Data" icon="clock">
    **Retention:** 24 hours
    **Purpose:** Immediate monitoring and alerts
  </Card>

  <Card title="Historical Data" icon="chart-line">
    **Retention:** 90 days
    **Purpose:** Long-term analysis and reporting
  </Card>
</Columns>

### Reporting

#### Automated Reports

<Steps>
  <Step title="Configure Report Frequency">
    Choose how often to generate reports:

    * **Daily**: For high-traffic sites
    * **Weekly**: For most websites
    * **Monthly**: For low-traffic sites
  </Step>

  <Step title="Select Report Recipients">
    Add email addresses for report delivery
  </Step>

  <Step title="Customize Report Content">
    Choose what data to include in reports
  </Step>

  <Step title="Set Up Alerts">
    Configure alerts for unusual activity
  </Step>
</Steps>

## Security Settings

### Access Control

#### Admin Permissions

<Columns cols={2}>
  <Card title="Plugin Management" icon="cog">
    **Who can:** Manage plugin settings
    **Default:** Administrators only
  </Card>

  <Card title="Analytics Access" icon="chart-bar">
    **Who can:** View analytics data
    **Default:** Administrators and Editors
  </Card>
</Columns>

#### API Security

<Steps>
  <Step title="API Key Management">
    Generate and manage API keys for external access
  </Step>

  <Step title="Rate Limiting">
    Set rate limits for API requests
  </Step>

  <Step title="IP Whitelisting">
    Restrict API access to specific IP addresses
  </Step>

  <Step title="Authentication">
    Configure authentication methods for API access
  </Step>
</Steps>

### Privacy Settings

#### Data Protection

<Checklist>
  <CheckboxItem>**Anonymize IP Addresses** - Remove personal information from logs</CheckboxItem>
  <CheckboxItem>**GDPR Compliance** - Ensure compliance with privacy regulations</CheckboxItem>
  <CheckboxItem>**Data Encryption** - Encrypt sensitive data in the database</CheckboxItem>
  <CheckboxItem>**Audit Logging** - Log all configuration changes</CheckboxItem>
</Checklist>

## Backup and Recovery

### Configuration Backup

<Steps>
  <Step title="Export Settings">
    Export your current configuration to a JSON file
  </Step>

  <Step title="Schedule Backups">
    Set up automatic configuration backups
  </Step>

  <Step title="Version Control">
    Keep track of configuration changes over time
  </Step>

  <Step title="Recovery Testing">
    Test your backup and recovery procedures
  </Step>
</Steps>

### Migration

#### Moving Between Sites

<Steps>
  <Step title="Export Configuration">
    Export settings from the source site
  </Step>

  <Step title="Import Configuration">
    Import settings to the destination site
  </Step>

  <Step title="Verify Settings">
    Check that all settings are correctly applied
  </Step>

  <Step title="Test Functionality">
    Verify that all features are working correctly
  </Step>
</Steps>

## Best Practices

### Configuration Recommendations

<Columns cols={2}>
  <Card title="Start Simple" icon="play">
    Begin with basic settings and add complexity gradually
  </Card>

  <Card title="Test Changes" icon="flask">
    Always test configuration changes in a staging environment
  </Card>

  <Card title="Document Settings" icon="file-text">
    Keep documentation of your configuration choices
  </Card>

  <Card title="Regular Reviews" icon="refresh">
    Review and update settings regularly
  </Card>
</Columns>

### Performance Optimization

<Note>
  Follow these tips to optimize plugin performance:
</Note>

* **Enable caching** for frequently accessed data
* **Use CDN** for static assets
* **Optimize database queries** in analytics
* **Monitor resource usage** during peak traffic
* **Regular cleanup** of old log files and data

### Security Best Practices

<Warning>
  Always follow security best practices when configuring the plugin:
</Warning>

* **Use strong passwords** for admin access
* **Enable two-factor authentication** where possible
* **Regular security updates** for WordPress and plugins
* **Monitor access logs** for suspicious activity
* **Backup configurations** before making changes