Frequently Asked Questions

Find answers to common questions and troubleshooting tips

Last Updated: July 20, 2025 | Version: 3.0.10

Quick Navigation

General Questions

What is LLMS SEO Optimizer?

LLMS SEO Optimizer is a WordPress plugin that helps your website become discoverable by AI search engines and language models. It creates and maintains LLMs.txt files - structured documents that AI systems can easily read and understand.

Key features:

  • Automatic content discovery
  • Smart description generation
  • SEO plugin integration
  • Multiple file variants
  • Content categorization
  • Real-time updates
What is LLMs.txt?

LLMs.txt is an emerging web standard (similar to robots.txt) specifically designed for AI language models. It provides structured information about your website content.

# Example LLMs.txt structure title: Homepage url: https://example.com description: Main website showcasing our products and services content_type: company last_updated: 2025-01-20 title: About Us url: https://example.com/about description: Learn about our company history and mission content_type: company last_updated: 2025-01-15

Purpose:

  • Helps AI understand your site structure
  • Provides context for content
  • Improves AI-generated responses about your site
  • Enables better AI search visibility
Why do I need this for my website?

AI Search is Growing:

  • 40% of searches now involve AI assistants
  • ChatGPT, Claude, and Perplexity are becoming primary search tools
  • Traditional SEO doesn't optimize for AI discovery

Benefits:

  1. Increased Visibility: Your content appears in AI responses
  2. Better Representation: Control how AI describes your site
  3. Future-Proofing: Stay ahead of search evolution
  4. Competitive Advantage: Most sites don't have LLMs.txt yet
How do AI search engines use this?

AI systems use LLMs.txt files to:

  1. Content Discovery
    • Find your most important pages
    • Understand site hierarchy
    • Identify content types
  2. Context Building
    • Use your descriptions for accurate responses
    • Understand content relationships
    • Provide relevant recommendations
  3. Fresh Information
    • Check last_updated timestamps
    • Prioritize recent content
    • Maintain accuracy

Real Example: When someone asks ChatGPT "What does [your company] offer?", it can use your LLMs.txt to provide accurate, up-to-date information.

Is this replacing traditional SEO?

No, it complements traditional SEO:

Traditional SEO AI SEO (GEO)
For search engines For AI models
Keywords focus Context focus
Meta tags Structured descriptions
Backlinks matter Content clarity matters
SERP rankings AI response inclusion

Best Practice: Use both traditional SEO and AI optimization for maximum visibility.

Installation & Setup

What are the system requirements?

Minimum Requirements:

  • WordPress 5.0+
  • PHP 7.4+
  • MySQL 5.6+
  • 64MB memory limit
  • Write permissions on root directory

Recommended:

  • WordPress 6.0+
  • PHP 8.0+
  • MySQL 8.0+
  • 128MB memory limit
  • SSL certificate

Check your system:

  1. Go to Tools → Site Health
  2. Check "Info" tab
  3. Verify PHP version and memory limit
Installation failed - what should I do?

Common causes and solutions:

1. "Installation failed: Could not create directory"
  • Cause: Insufficient permissions
  • Fix: Contact hosting to fix /wp-content/plugins/ permissions
2. "Plugin could not be activated"
  • Cause: PHP version too old
  • Fix: Upgrade PHP to 7.4 or higher
3. White screen after activation
  • Cause: Memory limit too low
  • Fix: Add to wp-config.php:
define('WP_MEMORY_LIMIT', '128M');
4. "Headers already sent" error
  • Cause: Extra spaces in files
  • Fix: Re-download and reinstall plugin
The plugin menu doesn't appear

Troubleshooting steps:

1. Check user permissions
  • Must have "manage_options" capability
  • Admin users only by default
2. Clear cache
  • Browser cache
  • WordPress admin cache
  • Server cache
3. Check for conflicts
  • Deactivate other plugins
  • Switch to default theme
  • Re-activate LLMS SEO
4. Verify installation
-- Check if plugin is in database SELECT option_value FROM wp_options WHERE option_name = 'active_plugins';
File permissions error

Error: "Unable to create llms.txt file"

Solution 1: Via FTP
# Connect via FTP and run: chmod 755 /path/to/wordpress/ chmod 644 /path/to/wordpress/llms.txt
Solution 2: Via hosting panel
  1. Access file manager
  2. Right-click WordPress root
  3. Set permissions to 755
  4. Apply recursively
Solution 3: Contact hosting
  • Some hosts restrict root access
  • Request write permissions for LLMs.txt files

Content & Limits

Why is there a 25-item limit?

Beta program features:

  • Allows manual selection of 25 items
  • Prevents server overload
  • Encourages thoughtful content curation
  • Sustainable free tier

This is enough for:

  • Small business sites
  • Personal blogs
  • Portfolio sites
  • Landing pages

Need more?

  • Unlimited content during beta
  • Premium options coming after beta
How can I get more content slots?
Method 1: Social Sharing (Free)
  1. No sharing required during beta
  2. Full access to all features
  3. Help shape the product roadmap
  4. Unlimited content selection
Method 2: Pro Version
  • Unlimited content slots
  • AI-powered descriptions
  • Advanced analytics
  • Email support
Method 3: Filters (Developers)
// Add to theme functions.php add_filter('llms_seo_free_limit', function($limit) { return 50; // Capped at 100 max });
What counts as an "item"?

One item = One URL, including:

  • Blog posts
  • Pages
  • Custom post types
  • WooCommerce products
  • Portfolio items

Not counted:

  • Drafts
  • Private posts
  • Trashed content
  • Password-protected posts
  • Excluded post types

Example count:

  • 10 blog posts = 10 items
  • 5 pages = 5 items
  • 10 products = 10 items
  • Total = 25 items
Can I change the limit programmatically?

Yes, but with restrictions:

// functions.php add_filter('llms_seo_free_limit', function($limit) { // Hard capped at 100 for security return min(75, $limit); });

Important:

  • Server-side validation enforces limits
  • No bonus system during beta
  • Changes require code modification
  • Respect the freemium model

File Generation

Files aren't generating

Diagnostic steps:

1. Check file permissions
ls -la /path/to/wordpress/ # Should show write permissions
2. Verify PHP execution time
  • Increase max_execution_time
  • Add to .htaccess:
php_value max_execution_time 300
3. Check error logs
  • Enable debug mode in plugin
  • Check /wp-content/uploads/llms-seo-optimizer-debug.log
4. Manual generation
  • Click "Regenerate All Files"
  • Watch for error messages
File shows as "Not Found"

Common causes:

1. File doesn't exist
  • Click "Regenerate All Files"
  • Check root directory via FTP
2. Security plugin blocking
  • Whitelist llms.txt in security plugin
  • Disable file access restrictions
3. Server configuration
  • Some hosts block root file access
  • Add to .htaccess:
<Files "llms*.txt"> Allow from all </Files>
4. CDN caching old 404
  • Purge CDN cache
  • Clear browser cache
Why are there different file versions?

Three variants for different needs:

File Size Content Use Case
llms.txt 5-10KB Balanced excerpts Standard AI crawlers
llms-full.txt 100-500KB Complete content Comprehensive indexing
llms-small.txt <1KB Minimal data Bandwidth-limited

When to use each:

  • Standard: Default for most sites
  • Full: Content-heavy sites, documentation
  • Small: Mobile-first, international users
llms-small.txt only shows 6 items

This is by design:

  • Strict 1KB file size limit
  • Each item needs ~150 bytes
  • Math: 1024 bytes ÷ 150 = ~6-8 items

Not a bug because:

  • Size limit is the constraint, not item count
  • Ensures ultra-fast loading
  • Meant for quick discovery

If you need more items:

  • Use standard llms.txt
  • Enable full variant
  • Consider your use case

Content Optimization

What's the description hierarchy?

LLMS SEO uses this priority order:

  1. Custom AI Description (Highest priority)
    • Set in post/page editor
    • Specifically written for AI
    • Overrides all other sources
  2. SEO Meta Description
    • From Yoast/RankMath/AIOSEO
    • Already optimized content
    • Good keyword inclusion
  3. Manual Excerpt
    • WordPress excerpt field
    • Hand-written summary
    • Author's intended description
  4. First Paragraph
    • Automatic extraction
    • Usually contains overview
    • Natural introduction
  5. Auto-generated (Lowest priority)
    • Truncated content
    • Basic but functional
    • Fallback option
How do I write good AI descriptions?

Best practices:

1. Be Specific
❌ Bad: "Article about SEO"
✅ Good: "Complete guide to optimizing WordPress sites for AI search engines using LLMs.txt"
2. Include Key Information
  • What the content covers
  • Who it's for
  • Key benefits/outcomes
3. Optimal Length
  • 100-300 characters
  • Complete thoughts
  • No keyword stuffing
4. AI-Friendly Language
  • Clear and direct
  • Avoid jargon
  • Include context

Template:

[Type] explaining [topic] for [audience], covering [key points]
What are optimization badges?

Three levels indicate content quality:

🟢 Optimized (Green)
  • Has custom AI description
  • Best for AI discovery
  • Manually reviewed
🟡 Partial (Yellow)
  • Using SEO meta description
  • Good but not ideal
  • Could be improved
⚪ Basic (Gray)
  • Auto-generated description
  • Minimal optimization
  • Needs attention

Improving badges:

  1. Add custom AI descriptions
  2. Write better excerpts
  3. Improve SEO meta
Content types vs WordPress categories

Important distinction:

WordPress Categories LLMS Content Types
Blog taxonomy AI-friendly classification
User-defined Automatic detection
For organization For AI understanding
Unlimited 5 standard types

Content Types:

  • Documentation: How-to, guides, tutorials
  • Products & Services: Offerings, features
  • Company: About, team, history
  • Support: FAQ, help, contact
  • Resources: Tools, downloads, links

Not the same as WordPress categories!

SEO Plugin Integration

Which SEO plugins are supported?

Fully integrated with:

1. Yoast SEO
  • All versions
  • Pulls meta descriptions
  • Respects noindex
2. Rank Math
  • Free and Pro
  • Uses meta descriptions
  • Schema integration
3. All in One SEO (AIOSEO)
  • Version 4.0+
  • Meta descriptions
  • Social meta
4. SEOPress
  • All versions
  • Meta content
  • Structured data

Integration is automatic - no configuration needed!

SEO descriptions aren't showing

Troubleshooting:

1. Check SEO plugin is active
// Test in functions.php if (defined('WPSEO_VERSION')) { echo "Yoast is active"; }
2. Verify meta descriptions exist
  • Edit a post
  • Check SEO panel
  • Ensure description is filled
3. Clear all caches
  • Plugin cache
  • SEO plugin cache
  • Server cache
4. Check priority conflicts
  • Custom descriptions override SEO
  • Some themes interfere
  • Disable other SEO addons
Can I use without an SEO plugin?

Absolutely! LLMS SEO works standalone:

Without SEO plugin, it uses:

  1. Manual excerpts
  2. First paragraph
  3. Auto-generated summaries

Benefits of SEO integration:

  • Reuse existing descriptions
  • Better keyword optimization
  • Consistent messaging

Standalone tips:

  • Focus on custom AI descriptions
  • Use WordPress excerpts
  • Write strong first paragraphs

Technical Issues

UTF-8 encoding problems

Symptoms:

  • Special characters show as �
  • Accented letters broken
  • Emojis not displaying

Solutions:

1. Database charset
-- Check charset SHOW VARIABLES LIKE 'character_set%'; -- Should be utf8mb4
2. WordPress config
// wp-config.php define('DB_CHARSET', 'utf8mb4'); define('DB_COLLATE', 'utf8mb4_unicode_ci');
3. File encoding
  • Files served with UTF-8 headers
  • Plugin handles this automatically
  • Check .htaccess for conflicts
Memory limit errors

Error: "Allowed memory size exhausted"

Quick fixes:

1. Increase PHP memory
// wp-config.php define('WP_MEMORY_LIMIT', '256M'); define('WP_MAX_MEMORY_LIMIT', '512M');
2. Optimize content selection
  • Reduce number of items
  • Use smaller content depth
  • Disable file variants
3. Server-level fix
; php.ini memory_limit = 256M
Timeout during generation

Error: "Maximum execution time exceeded"

Solutions:

1. Increase time limit
// .htaccess php_value max_execution_time 300
2. Generate fewer items
  • Start with 10 items
  • Gradually increase
  • Find server's limit
3. Optimize server
  • Upgrade PHP version
  • Enable OpCache
  • Use better hosting
Plugin conflicts

Common conflicts:

1. Security plugins
  • Wordfence: Whitelist file creation
  • Sucuri: Allow llms.txt
  • iThemes: Adjust file permissions
2. Caching plugins
  • Exclude llms*.txt from cache
  • Clear cache after generation
  • Disable object caching for admin
3. SEO plugins
  • Only one primary SEO plugin
  • Disable duplicate features
  • Check meta priority

Conflict resolution:

  1. Deactivate all plugins
  2. Activate LLMS SEO alone
  3. Test generation
  4. Reactivate plugins one by one

Performance & Maintenance

Impact on site performance

Minimal impact:

✅ Frontend Performance
  • No database queries
  • Static file serving
  • Cache-friendly
  • CDN compatible
✅ Backend Performance
  • Generation only on changes
  • Efficient algorithms
  • Batched operations
  • Low memory usage

Benchmarks:

  • File generation: <1 second
  • Memory usage: <50MB
  • CPU impact: Negligible
  • Page load: No change
How often should I update content?

Recommended schedule:

📅 Daily
  • Automatic updates handle this
  • New content added
  • Edits reflected
📅 Weekly
  • Review optimization badges
  • Update priority content
  • Check file accessibility
📅 Monthly
  • Audit content selection
  • Update AI descriptions
  • Review analytics
📅 Quarterly
  • Strategic content review
  • Analyze AI trends
  • Plan improvements
Backup and migration

Before updates:

1. Export settings
-- Backup LLMS SEO options SELECT * FROM wp_options WHERE option_name LIKE 'llms_seo_%';
2. Save files
  • Download llms.txt
  • Keep custom descriptions
  • Document selections
3. Migration steps
  • Install on new site
  • Import database tables
  • Regenerate files
  • Verify functionality
Debugging problems

Enable debug mode:

1. Plugin debug
  • Settings → Enable debug logging
  • Check logs in uploads folder
2. WordPress debug
// wp-config.php define('WP_DEBUG', true); define('WP_DEBUG_LOG', true); define('WP_DEBUG_DISPLAY', false);
3. Generate support report
  • Debug section → Generate Report
  • Reviews before download
  • Share with support

Common debug findings:

  • Permission errors
  • Memory limits
  • Plugin conflicts
  • Encoding issues

Getting Additional Help

Support Channels

1. Community Forums
  • Coming soon
  • Peer-to-peer support
  • Community discussions
2. Documentation
3. Pro Support
  • Email support
  • Best effort responses
  • Custom solutions

Before Requesting Support

✅ Gather information:

  • WordPress version
  • PHP version
  • Error messages
  • Debug log
  • Support report

✅ Try basic fixes:

  • Regenerate files
  • Clear cache
  • Check permissions
  • Review FAQ

✅ Be specific:

  • Exact error message
  • Steps to reproduce
  • Expected behavior
  • Actual behavior
Visit Support