> ## 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.

# Protection Modes

> Comprehensive guide to LLMTAG protection modes and how to configure them

## Protection Modes Overview

The LLMTAG plugin offers three distinct protection modes, each designed for different use cases and levels of AI protection. Choose the mode that best fits your website's needs.

<Card title="Choose Your Protection Level" icon="shield" horizontal>
  **Basic** • **Standard** • **Advanced** - Each mode offers increasing levels of protection and customization
</Card>

## Basic Mode

### What It Does

Basic Mode provides essential AI protection through passive declaration only:

* **llmtag.txt Generation**: Automatically creates a compliant llmtag.txt file
* **Policy Declaration**: Communicates your AI usage policies to compliant agents
* **No Active Blocking**: Relies on AI agents to respect your policies voluntarily

### Best For

<Columns cols={2}>
  <Card title="Personal Blogs" icon="blog">
    **Perfect for:** Individual bloggers, hobby sites, personal websites

    **Why:** Simple setup with minimal configuration required
  </Card>

  <Card title="Simple Websites" icon="globe">
    **Perfect for:** Small business sites, portfolio sites, basic websites

    **Why:** Lightweight protection without performance impact
  </Card>
</Columns>

### Configuration

Basic Mode uses a simple configuration interface:

```txt theme={null}
# Generated llmtag.txt example
spec_version: 3.0
ai_training_data: disallow
ai_use: search_indexing
```

<Steps>
  <Step title="Set Global Policy">
    Choose your default AI training and usage policies for the entire site.
  </Step>

  <Step title="Generate llmtag.txt">
    The plugin automatically generates and serves your llmtag.txt file.
  </Step>

  <Step title="Monitor Compliance">
    Check if AI agents are respecting your policies (passive monitoring only).
  </Step>
</Steps>

### Limitations

<Warning>
  Basic Mode does not actively block AI agents. It relies on voluntary compliance with your llmtag.txt policies.
</Warning>

* **No Active Blocking**: AI agents can still access your content
* **Limited Analytics**: Basic monitoring only
* **No Custom Rules**: Cannot set agent-specific or path-specific policies
* **No Advanced Features**: No verification challenges or custom directives

## Standard Mode

### What It Does

Standard Mode combines passive declaration with active AI agent blocking:

* **llmtag.txt Generation**: Full llmtag.txt file with customizable policies
* **AI Agent Blocking**: Blocks 60+ known AI agents and crawlers
* **Basic Analytics**: Tracks blocked requests and agent activity
* **Path-Based Protection**: Different policies for different content sections

### Best For

<Columns cols={2}>
  <Card title="Business Websites" icon="briefcase">
    **Perfect for:** Company websites, professional blogs, business portfolios

    **Why:** Balanced protection with good performance and useful analytics
  </Card>

  <Card title="Content Sites" icon="newspaper">
    **Perfect for:** News sites, content publishers, educational sites

    **Why:** Protects content while maintaining search engine visibility
  </Card>
</Columns>

### Configuration

Standard Mode offers comprehensive configuration options:

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

# Protect premium content
Path: /premium/
ai_training_data: disallow
ai_use: search_indexing

# Allow research bots
User-agent: ResearchBot
ai_training_data: allow
ai_use: research
```

<Steps>
  <Step title="Configure Global Policies">
    Set your default AI training and usage policies.
  </Step>

  <Step title="Select AI Agents to Block">
    Choose which AI agents to block from the database of 60+ agents.
  </Step>

  <Step title="Set Path-Based Rules">
    Configure different policies for different sections of your site.
  </Step>

  <Step title="Enable Analytics">
    Activate monitoring and reporting features.
  </Step>
</Steps>

### Features

<Checklist>
  <CheckboxItem>**60+ AI Agent Blocking** - Proactively block known AI crawlers</CheckboxItem>
  <CheckboxItem>**Path-Based Protection** - Different rules for different content types</CheckboxItem>
  <CheckboxItem>**Basic Analytics** - Track blocked requests and agent activity</CheckboxItem>
  <CheckboxItem>**Agent-Specific Rules** - Allow or block specific AI agents</CheckboxItem>
  <CheckboxItem>**Real-time Monitoring** - See protection activity as it happens</CheckboxItem>
</Checklist>

## Advanced Mode

### What It Does

Advanced Mode provides the most comprehensive AI protection available:

* **Full llmtag.txt Customization**: Complete control over all directives and rules
* **Advanced AI Agent Blocking**: Custom agent lists, whitelisting, and exceptions
* **Comprehensive Analytics**: Detailed reporting, trends, and insights
* **Custom Rules Engine**: Create complex, conditional protection rules
* **Developer API**: Full API access for custom integrations
* **Verification Challenges**: Cryptographic verification for advanced compliance

### Best For

<Columns cols={2}>
  <Card title="Enterprise Sites" icon="building">
    **Perfect for:** Large corporations, enterprise websites, high-traffic sites

    **Why:** Maximum protection with full customization and enterprise features
  </Card>

  <Card title="High-Value Content" icon="diamond">
    **Perfect for:** Premium content sites, subscription services, proprietary information

    **Why:** Advanced protection for valuable intellectual property
  </Card>
</Columns>

### Configuration

Advanced Mode offers complete control over all aspects of AI protection:

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

# Custom verification challenge
verification_challenge: sha256:custom_hash_here

# Complex agent-specific rules
User-agent: GPTBot
ai_training_data: allow
ai_use: search_indexing, generative_synthesis, research

User-agent: CommercialAI
ai_training_data: disallow
ai_use: search_indexing

# Advanced path-based protection
Path: /premium/
ai_training_data: disallow
ai_use: search_indexing
verification_challenge: sha256:premium_verification_hash

Path: /research/
ai_training_data: allow
ai_use: search_indexing, generative_synthesis, research
```

<Steps>
  <Step title="Configure Global Policies">
    Set comprehensive default policies with custom directives.
  </Step>

  <Step title="Create Custom Agent Rules">
    Define complex rules for specific AI agents and scenarios.
  </Step>

  <Step title="Set Up Path Protection">
    Configure advanced path-based protection with verification challenges.
  </Step>

  <Step title="Enable Advanced Analytics">
    Activate comprehensive monitoring, reporting, and insights.
  </Step>

  <Step title="Configure API Access">
    Set up developer API access for custom integrations.
  </Step>
</Steps>

### Advanced Features

<Checklist>
  <CheckboxItem>**Custom Directives** - Add custom llmtag.txt directives</CheckboxItem>
  <CheckboxItem>**Verification Challenges** - Cryptographic verification for compliance</CheckboxItem>
  <CheckboxItem>**Conditional Rules** - Complex, conditional protection logic</CheckboxItem>
  <CheckboxItem>**API Integration** - Full REST API for external systems</CheckboxItem>
  <CheckboxItem>**Advanced Analytics** - Detailed insights and trend analysis</CheckboxItem>
  <CheckboxItem>**Custom Agent Management** - Add and manage custom AI agents</CheckboxItem>
  <CheckboxItem>**Performance Optimization** - Advanced caching and optimization</CheckboxItem>
  <CheckboxItem>**Audit Logging** - Complete audit trail of all actions</CheckboxItem>
</Checklist>

## Mode Comparison

### Feature Matrix

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

    * ✅ llmtag.txt generation
    * ✅ Basic policy declaration
    * ❌ AI agent blocking
    * ❌ Analytics
    * ❌ Custom rules
    * ❌ API access

    **Performance Impact:** Minimal
    **Setup Time:** 2 minutes
    **Best For:** Simple sites, personal blogs
  </Tab>

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

    * ✅ llmtag.txt generation
    * ✅ Policy declaration
    * ✅ AI agent blocking (60+ agents)
    * ✅ Basic analytics
    * ✅ Path-based rules
    * ❌ Custom directives
    * ❌ API access

    **Performance Impact:** Low
    **Setup Time:** 5 minutes
    **Best For:** Business sites, content publishers
  </Tab>

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

    * ✅ llmtag.txt generation
    * ✅ Policy declaration
    * ✅ AI agent blocking (unlimited)
    * ✅ Comprehensive analytics
    * ✅ All rule types
    * ✅ Custom directives
    * ✅ API access
    * ✅ Verification challenges

    **Performance Impact:** Moderate
    **Setup Time:** 15 minutes
    **Best For:** Enterprise sites, high-value content
  </Tab>
</Tabs>

## Choosing the Right Mode

### Decision Matrix

<Columns cols={2}>
  <Card title="Choose Basic If:" icon="check">
    * You have a simple website
    * You want minimal setup
    * You trust AI agents to comply voluntarily
    * You don't need detailed analytics
  </Card>

  <Card title="Choose Standard If:" icon="star">
    * You have a business website
    * You want active AI agent blocking
    * You need basic analytics
    * You want path-based protection
  </Card>

  <Card title="Choose Advanced If:" icon="crown">
    * You have enterprise requirements
    * You need maximum protection
    * You want full customization
    * You need API integration
  </Card>

  <Card title="Upgrade Anytime" icon="arrow-up">
    * You can upgrade between modes
    * Your settings are preserved
    * No data loss during upgrade
    * Easy one-click upgrade process
  </Card>
</Columns>

## Mode Configuration

### Switching Between Modes

<Steps>
  <Step title="Access Settings">
    Go to **LLMTAG > Settings** in your WordPress admin.
  </Step>

  <Step title="Select New Mode">
    Choose your desired protection mode from the dropdown.
  </Step>

  <Step title="Review Changes">
    The system will show you what features will be added or removed.
  </Step>

  <Step title="Confirm Switch">
    Click **Save Changes** to apply the new mode.
  </Step>

  <Step title="Verify Configuration">
    Check that all features are working correctly in the new mode.
  </Step>
</Steps>

### Preserving Settings

<Info>
  When switching between modes, your existing settings are preserved. Features that are not available in the new mode will be disabled but not deleted.
</Info>

* **Global Policies**: Preserved across all modes
* **Path-Based Rules**: Preserved in Standard and Advanced modes
* **Agent Blocking**: Preserved in Standard and Advanced modes
* **Custom Rules**: Preserved in Advanced mode only
* **API Settings**: Preserved in Advanced mode only

## Performance Considerations

### Resource Usage by Mode

<Columns cols={2}>
  <Card title="Basic Mode" icon="leaf">
    **CPU Usage:** \< 1%
    **Memory Usage:** \< 5MB
    **Database Queries:** Minimal
    **Page Load Impact:** \< 5ms
  </Card>

  <Card title="Standard Mode" icon="balance-scale">
    **CPU Usage:** 1-3%
    **Memory Usage:** 10-20MB
    **Database Queries:** Low
    **Page Load Impact:** 5-15ms
  </Card>

  <Card title="Advanced Mode" icon="cog">
    **CPU Usage:** 3-5%
    **Memory Usage:** 20-50MB
    **Database Queries:** Moderate
    **Page Load Impact:** 15-30ms
  </Card>
</Columns>

### Optimization Tips

<Steps>
  <Step title="Enable Caching">
    Use WordPress caching plugins to minimize performance impact.
  </Step>

  <Step title="Optimize Database">
    Regularly clean up old analytics data to maintain performance.
  </Step>

  <Step title="Monitor Resources">
    Use the plugin's built-in performance monitoring to track resource usage.
  </Step>

  <Step title="Scale Gradually">
    Start with Basic mode and upgrade as your needs grow.
  </Step>
</Steps>

## Troubleshooting

### Common Issues by Mode

<AccordionGroup>
  <Accordion title="Basic Mode - llmtag.txt not accessible">
    **Symptoms:** File returns 404 or 403 errors
    **Solutions:**

    * Check file permissions (should be 644)
    * Verify .htaccess rules
    * Clear caching plugins
    * Contact hosting provider
  </Accordion>

  <Accordion title="Standard Mode - AI agents not blocked">
    **Symptoms:** AI agents still accessing content
    **Solutions:**

    * Verify protection is enabled
    * Check AI agent database is updated
    * Review .htaccess modifications
    * Test with different user agents
  </Accordion>

  <Accordion title="Advanced Mode - Performance issues">
    **Symptoms:** Slow page loads, high resource usage
    **Solutions:**

    * Enable caching
    * Optimize database queries
    * Reduce analytics data retention
    * Consider upgrading server resources
  </Accordion>
</AccordionGroup>

## Best Practices

### Mode Selection

<Columns cols={2}>
  <Card title="Start Simple" icon="play">
    Begin with Basic mode and upgrade as your needs grow. This ensures optimal performance and avoids over-engineering.
  </Card>

  <Card title="Match Your Needs" icon="target">
    Choose the mode that matches your actual requirements, not just the most advanced option.
  </Card>

  <Card title="Monitor Performance" icon="chart-line">
    Regularly monitor your site's performance and adjust the mode if needed.
  </Card>

  <Card title="Plan for Growth" icon="trending-up">
    Consider your future needs when selecting a mode to avoid frequent changes.
  </Card>
</Columns>

### Configuration Tips

<Note>
  Follow these tips for optimal configuration in any mode:
</Note>

* **Test thoroughly** after switching modes
* **Backup settings** before making major changes
* **Monitor analytics** to ensure protection is working
* **Update regularly** to get the latest AI agent blocking
* **Document your configuration** for future reference
