Documentation

1. Introduction

LLMS SEO Optimizer is a WordPress plugin that makes your website discoverable by AI search engines like ChatGPT, Claude, and Perplexity. It implements the LLMs.txt standard - a specialized file format that helps AI systems understand and index your content effectively.

What is LLMs.txt?

LLMs.txt is like a sitemap for AI. Just as XML sitemaps help Google understand your site structure, LLMs.txt helps AI language models discover and comprehend your content. The file contains:

• Structured content listings
• Optimized descriptions
• Semantic categorization
• Content hierarchy

Why This Matters

With the rise of AI-powered search (Generative Engine Optimization or GEO), traditional SEO is no longer enough. Users increasingly rely on AI assistants for information, and these systems need structured data to provide accurate responses about your content.

2. Pre-Installation Requirements

System Requirements

Required Permissions

• Write permissions on WordPress root directory
• Ability to install WordPress plugins
• Access to WordPress admin panel

Compatibility Check

Before installation, verify:

1. Your hosting environment meets the requirements
2. No conflicts with security plugins that might block file creation
3. Your theme doesn't interfere with admin functionality

3. Installation Methods

4. Initial Setup

First-Time Configuration Wizard

Upon activation, the plugin automatically:

1. Creates default settings
2. Generates an initial LLMs.txt file
3. Sets up database tables for optimization data

Accessing the Plugin

1. Click ⚡ LLMS SEO in the admin menu
2. You'll see the main dashboard with:
   • File Status indicators
   • Quick Action buttons
   • Navigation sidebar

Initial File Generation

The plugin generates your first LLMs.txt file automatically with:

• Your site's basic information
• Recent posts and pages
• Default content descriptions

5. Understanding the Dashboard

File Status Section

The dashboard displays three status boxes:

Quick Actions

• Save Settings: Saves all configuration changes
• Regenerate All Files: Manually triggers file generation
• View Files: Dropdown to preview each file variant

Navigation Sidebar

• File Status
• File Variants
• Optimization
• Settings
• Content Selection
• Debug Info (if enabled)
• About

6. Configuration Guide

Basic Settings

1. Auto-Update Feature

• Enabled: Files update when you publish/edit content
• Disabled: Manual regeneration required

2. Content Inclusion

• Select which content types to include
• Both enabled by default

3. Content Depth

Choose how much content to include:

• Title only: Just titles, no descriptions
• Excerpt only: 100 character descriptions
• Summary: 300 character descriptions (default)
• Extended: 500 character descriptions
• Full content: Complete text

4. Maximum Items

• Set between 5-100 items
• Default: 20 items
• Applies to automatic selection only

5. Group by Content Type

When enabled, groups content into:

• Documentation
• Products & Services
• Company Information
• Support
• Resources

Advanced Settings

Enable File Variants

Creates additional files:

• llms-full.txt: Complete content
• llms-small.txt: Minimal version

Custom Post Types

Select additional content types:

• WooCommerce Products
• Event Calendar Events
• Portfolio Items
• Custom post types from themes/plugins

7. Content Selection Strategies

Understanding the Limit

Free version allows 25 manually selected items. Use them wisely:

1. Priority Content First
   • Homepage
   • Main service/product pages
   • About/Contact pages
   • Top-performing blog posts
2. Beta Program Benefits
   • Unlimited content selection
   • Full access to all features
   • Help shape the product roadmap

Selection Best Practices

For Business Sites

1. Company overview page
2. Main products/services (5-10 items)
3. Key landing pages
4. Recent blog posts showcasing expertise
5. Contact and support pages

For Blogs

1. Pillar content pieces
2. Most popular posts
3. Recent high-quality articles
4. Category pages
5. About the author page

For E-commerce

1. Homepage
2. Main category pages
3. Best-selling products
4. Featured collections
5. Customer service pages

Using View Modes

Toggle between:

• Simple View: Just titles and checkboxes
• Full Edit View: Inline description editing

8. File Generation Process

Automatic Generation

Files regenerate when:

• Content is published
• Content is updated
• Content is deleted
• Settings are saved

Manual Generation

Click "Regenerate All Files" when:

• Bulk importing content
• After major site changes
• Troubleshooting file issues
• Testing different settings

Generation Process

1. Content Collection
   • Gathers selected posts/pages
   • Retrieves descriptions
   • Applies content depth settings
2. Description Hierarchy
   • Custom AI description (if set)
   • SEO meta description
   • Manual excerpt
   • First paragraph
   • Auto-generated excerpt
3. File Creation
   • Generates markdown format
   • Applies UTF-8 encoding
   • Creates all enabled variants
   • Updates file status

Monitoring Generation

Watch for:

• Success messages
• File size indicators
• Last generated timestamp
• Error notifications

9. Advanced Settings

Debug Mode

When enabled:

• Creates detailed log file
• Shows Debug Information panel
• Tracks all plugin operations
• Helps diagnose issues

Custom Descriptions

Each post/page can have:

1. Custom AI Description
   • Overrides automatic generation
   • Optimized for AI understanding
   • 100-500 characters recommended
2. Content Type Override
   • Change automatic categorization
   • Select from dropdown in editor

Optimization Levels

Content receives badges:

• Optimized (Green): Has custom AI description
• Partial (Yellow): Using SEO meta description
• Basic (Gray): Using auto-generated content

10. SEO Plugin Integration

Supported SEO Plugins

LLMS SEO Optimizer integrates with:

Integration Benefits

1. No Duplicate Work
   • Reuses existing SEO descriptions
   • Saves time and effort
   • Maintains consistency
2. Enhanced Optimization
   • Combines SEO and AI optimization
   • Leverages existing keyword research
   • Improves overall visibility

Setup Integration

No configuration needed - integration is automatic:

1. Install/activate your SEO plugin
2. LLMS SEO Optimizer detects it
3. Descriptions pulled automatically
4. Override with custom AI descriptions if needed

11. Performance Optimization

File Size Management

Standard File (llms.txt)

• Target size: 5-10KB
• Balance between detail and speed
• Suitable for most AI crawlers

Full File (llms-full.txt)

• Size: 100-500KB
• Complete content included
• For comprehensive indexing

Small File (llms-small.txt)

• Strict 1KB limit
• Shows ~6 items only
• For bandwidth-limited scenarios

Server Performance

Optimize for better performance:

1. Caching Compatibility
   • Works with all major caching plugins
   • Static files serve quickly
   • No database queries for file access
2. CDN Integration
   • Files can be served via CDN
   • Improves global accessibility
   • Reduces server load
3. Resource Usage
   • Minimal CPU usage
   • Low memory footprint
   • Efficient file operations

Best Practices

1. Regular Maintenance
   • Review selected content monthly
   • Update descriptions for accuracy
   • Remove outdated content
2. Monitor File Sizes
   • Check file status regularly
   • Ensure files aren't too large
   • Balance content depth with size
3. Test Accessibility
   • Visit yoursite.com/llms.txt
   • Verify proper encoding
   • Check load times

12. Maintenance & Updates

Automatic Updates

WordPress handles plugin updates:

• Notifications in admin panel
• One-click updates
• Security patches as needed

Manual Maintenance

Regular tasks:

1. Monthly Review
   • Check optimization scores
   • Update content selection
   • Refresh old descriptions
2. Quarterly Audit
   • Review analytics (when available)
   • Adjust content strategy
   • Test file accessibility
3. Annual Planning
   • Evaluate AI search trends
   • Plan content updates
   • Consider Pro upgrade

Troubleshooting Updates

If issues after update:

1. Regenerate all files
2. Clear cache
3. Check file permissions
4. Review debug log
5. Use support diagnostics tool

Backup Recommendations

Before major updates:

1. Backup WordPress database
2. Save current LLMs.txt files
3. Export plugin settings
4. Document customizations

Getting Help

Support Resources

1. Documentation: This guide and FAQ
2. Support Forum: Community forums (coming soon)
3. Email Support: Beta users (best effort basis)

Using Support Diagnostics

Generate comprehensive report:

1. Enable Debug Mode
2. Go to Debug Information section
3. Click "Generate Support Report"
4. Review and download
5. Include with support requests