Troubleshooting

Files Not Generating

Check file permissions

CitedPro needs write access to create files. Verify:

• Your WordPress root directory is writable, OR
• The wp-content/uploads/ directory is writable

Check for plugin conflicts

Some security plugins block file creation. Temporarily disable security plugins and try again.

Fallback location

If files can't be created in the root, they're placed in wp-content/uploads/srsk/. Check the Files tab to see the actual file locations.

Files Not Accessible (404)

Caching issues

• Clear your browser cache
• Clear any caching plugin cache
• Clear CDN cache (Cloudflare, etc.)
• Wait for server cache to expire

Permalink issues

1. Go to Settings → Permalinks
2. Click Save Changes (flushes rewrite rules)
3. Try accessing the files again

Server configuration

Some servers block access to .txt or .json files. Contact your host or add these rules:

Apache (.htaccess):

<Files "llms.txt">
    Allow from all
</Files>
<Files "site-data.json">
    Allow from all
</Files>

Nginx:

location ~ ^/(llms\.txt|site-data\.json)$ {
    allow all;
}

Bot Tracking Not Working

Tracking not enabled

1. Go to CitedPro → Settings
2. Ensure Enable Bot Tracking is on
3. Save changes

No bots visiting

AI bots may not have discovered your site yet. This is normal for new sites. Ensure:

• Your site is publicly accessible (not password protected)
• robots.txt doesn't block AI bots
• Your site has some backlinks or traffic

Caching blocking detection

Full-page caching may bypass the tracking code. Ensure bot requests aren't served from cache.

LLM Referral Tracking Not Working (Pro)

License not active

LLM referral tracking requires an active Pro license. Go to CitedPro → License to verify your license is active.

JavaScript not loading

The referral tracker requires JavaScript. Check for:

• JavaScript errors in browser console
• Plugins that might be blocking scripts
• Content Security Policy blocking inline scripts

Referrer stripped

Some browsers and privacy tools strip referrer headers. This is expected — you'll track referrals from users who haven't enabled strict privacy settings.

Smart Generate Not Working (Pro)

Daily limit reached

Smart Generate has a limit of 30 generations per day. Wait until midnight UTC for the limit to reset.

API connection failed

• Check your internet connection
• Verify your license is active
• Try again in a few moments
• Check if your host blocks outgoing API calls

Poor quality output

Provide more context in your business information. The more data Smart Generate has, the better the results.

Schema Not Appearing

Minimum data required

Schema injection requires at least a business name and description. Complete the Setup wizard.

Check settings

1. Go to CitedPro → Settings
2. Ensure Enable Schema Injection is on

Caching

Clear your cache after making changes. View page source to verify schema is present.

Plugin conflicts

Other SEO plugins may also inject Organization schema. This isn't harmful but may be redundant. Consider disabling duplicate schema in one plugin.

License Issues

License not activating

• Verify you're entering the correct license key
• Check for extra spaces before or after the key
• Ensure your site can make outgoing API calls

License deactivated unexpectedly

• Your license may have expired — check your purchase email
• You may have activated on too many sites — deactivate unused sites
• Payment may have failed for renewal

Getting Help

If you've tried the above solutions and still have issues:

1. Enable debug mode: Go to CitedPro → Tools and enable debug logging
2. Check error log: Review the error log in the Tools tab
3. Contact support:Contact us with:
   • WordPress version
   • CitedPro version
   • PHP version
   • Detailed description of the issue
   • Steps to reproduce
   • Error log entries (if any)