tommyoz12

AI-Only Pages gives you granular control over which search engine bots can index each page on your WordPress site — while simultaneously making those pages more discoverable and useful for AI crawlers like ChatGPT, Claude, and Perplexity.
The core idea: you have content that is perfect for AI training pipelines and retrieval-augmented generation (RAG) systems, but you do not want that content competing for rankings in Google, Bing, or Yahoo.
AI-Only Pages lets you mark those pages as AI-only: they disappear from traditional search engine indexes while becoming first-class citizens in the AI ecosystem.
<h4>What it does</h4>
<ul>
<li>Per-bot noindex — Block individual bots (Googlebot, Bingbot, Yandexbot, etc.) with a checkbox per bot per page. Checking one bot blocks it; the others still index normally.</li>
<li>“Block All” master toggle — One click blocks all 10 supported search engine bots simultaneously.</li>
<li><code><meta></code> tags and HTTP headers — Both <code><meta name="googlebot" content="noindex, nofollow"></code> HTML meta tags and <code>X-Robots-Tag</code> HTTP headers are emitted, covering all crawling contexts. Works correctly on all public post types including Pages and custom post types.</li>
<li>SEO plugin integration — Suppresses Yoast SEO, WP Core, and RankMath’s global <code><meta name="robots"></code> tag on AI-only pages so there is no conflict between the global tag and your per-bot tags.</li>
<li>Sitemap exclusion — AI-Only pages are automatically removed from all XML sitemaps (Yoast SEO and WP Core sitemaps are both supported).</li>
<li><code>/llms-index.txt</code> — A plain-text AI discovery file served at <code>yoursite.com/llms-index.txt</code> listing all AI-only pages with their titles and last-modified dates. AI crawlers can use this file to find your AI-optimised content directly. Can be toggled on/off from the settings page.</li>
<li>Token Diet — clean AI output — When an AI crawler visits an AI-only page, the plugin serves a cleaned version of the HTML with navigation, sidebars, footers, cookie banners, inline styles, SVGs, and iframes stripped out. AI models receive pure content with minimal noise.</li>
<li>Global Settings Page — A top-level “AI-Only Pages” menu in the WordPress admin sidebar lets you configure Token Diet and LLM Index behaviour globally, without touching code.</li>
<li>Caching plugin notice — If WP Rocket, LiteSpeed Cache, or another full-page caching plugin is detected, an admin notice explains how to configure it to work alongside this plugin.</li>
</ul>
<h4>The Settings Page</h4>
A full settings page is available under AI-Only Pages in the WordPress admin sidebar. It provides:
Section 1 — Instructions & Status: A “How It Works” guide covering the meta box, Token Diet, and LLM Index. A live, clickable URL to your <code>/llms-index.txt</code> file with a green/red status indicator showing whether the index is active.
Section 2 — LLM Index Settings: A toggle to enable or disable <code>/llms-index.txt</code> globally. When disabled, the endpoint returns a 404.
Section 3 — Token Diet Master Control: A master toggle to enable or disable Token Diet entirely. When off, AI bots receive raw, full HTML — identical to what human visitors see.
Section 4 — Granular Token Diet Stripping: Individual toggles for each category of content stripped:
<ul>
<li>Strip structural layout (headers, footers, sidebars, navigation, cookie banners)</li>
<li>Strip <code><style></code> tags and embedded CSS</li>
<li>Strip <code><svg></code> elements (major token bloaters)</li>
<li>Strip <code><iframe></code> elements (maps, embeds, social widgets)</li>
<li>Strip <code><form></code> elements (Warning: removes WooCommerce Add to Cart buttons)</li>
<li>Strip <code><script></code> tags (Note: <code>application/ld+json</code> schema is always preserved)</li>
</ul>
<h4>Supported Search Engine Bots</h4>
Googlebot (Web), Googlebot-Image, Googlebot-News, Googlebot-Video, AdsBot-Google, Bingbot, Slurp (Yahoo), DuckDuckBot, Baiduspider, YandexBot.
<h4>AI Bots Welcomed</h4>
GPTBot, ChatGPT-User, ClaudeBot, PerplexityBot, YouBot, Meta-ExternalAgent, Amazonbot, Bytespider, Diffbot, cohere-ai, anthropic-ai, AI2Bot, OAI-SearchBot, and more. These bots are detected automatically and served cleaned content when they visit an AI-only page.
<h4>Developer-Friendly</h4>
Every major behaviour is extensible via WordPress filters. See the Developer Reference section below. The Settings class hooks into filters at priority 5, leaving priorities 10 and above free for developer overrides — so your custom <code>add_filter()</code> calls always win.
<h3>Using the Plugin</h3>
<h4>Per-page control</h4>
<ol>
<li>Open any post or page in the WordPress editor.</li>
<li>Find the AI-Only Pages meta box in the right sidebar.</li>
<li>Check individual bots to block them, or use Block from ALL search engine bots to check all at once.</li>
<li>Click Publish or Update to save. The noindex tags take effect immediately.</li>
<li>Visit <code>yoursite.com/llms-index.txt</code> to confirm your page appears in the AI content index.</li>
</ol>
Note: The master toggle requires JavaScript. The individual checkboxes always work regardless of JS state.
<h4>Global settings</h4>
<ol>
<li>Go to AI-Only Pages in the WordPress admin sidebar.</li>
<li>Review the “How It Works” section and confirm your <code>/llms-index.txt</code> URL is live.</li>
<li>Use the LLM Index Settings card to enable or disable the discovery file.</li>
<li>Use the Token Diet — Master Control card to enable or disable all output cleaning.</li>
<li>Use the Token Diet — Granular Stripping card to select exactly which HTML elements are stripped from AI output.</li>
<li>Click Save Settings.</li>
</ol>
<h3>Developer Reference</h3>
All filters are applied inside <code>AIOnly\Pages\Plugin</code>. The Settings class hooks at priority 5; standard developer priority is 10+.
<code>aionly_ai_crawler_signatures</code> 
Array of User-Agent substrings used for Layer 1 bot detection. 
 @param string[] $signatures 
 @return string[]
<code>aionly_strip_selectors</code> 
CSS-style selector strings passed to Pass 1 of Token Diet (structural removal). Supports element tag, #id, and .class (one class, no combinators). 
 @param string[] $selectors 
 @return string[]
<code>aionly_strip_token_bloat_tags</code> 
XPath query strings passed to Pass 2 of Token Diet (tag removal). 
 @param string[] $queries 
 @return string[]
<code>aionly_allowed_attributes</code> 
HTML attribute names kept on every element by Pass 3 of Token Diet. Everything else is stripped. 
 @param string[] $attributes 
 @return string[]
<code>aionly_should_clean_output</code> 
Boolean. Return false to disable Token Diet entirely for a specific post. 
 @param bool $enabled Default: true. 
 @param \WP_Post $post 
 @return bool
<code>aionly_enable_xrobots_headers</code> 
Boolean. Return false to suppress X-Robots-Tag HTTP headers. 
 @param bool $enabled Default: true. 
 @param \WP_Post $post 
 @return bool
<code>aionly_cache_ttl</code> 
Filter the transient TTL in seconds. 
 @param int $ttl Default: 600 (10 minutes). 
 @return int
<code>aionly_llms_index_lines</code> 
Filter the array of text lines that make up llms-index.txt before output. 
 @param string[] $lines Array of lines (including comment lines). 
 @param int[] $active_ids Post IDs included in the index. 
 @return string[]
<code>aionly_supported_post_types</code> 
Array of public post type slugs the plugin should support. 
 @param string[] $post_types 
 @return string[]
<code>aionly_use_heuristic_bot_detection</code> 
Boolean. Return false to disable Layer 2 heuristic bot detection. 
 @param bool $enabled Default: true. 
 @return bool
<h4>Code Examples</h4>
Disable heuristic bot detection (uptime monitors):
<pre><code>add_filter( 'aionly_use_heuristic_bot_detection', '__return_false' );
</code></pre>
Preserve WooCommerce forms (developer override — wins over settings page):
<pre><code>add_filter( 'aionly_strip_token_bloat_tags', function( $queries ) {
 return array_filter( $queries, function( $q ) {
 return $q !== '//form';
 } );
} );
</code></pre>
Add a custom strip selector:
<pre><code>add_filter( 'aionly_strip_selectors', function( $selectors ) {
 $selectors[] = '.advertisement';
 $selectors[] = '#newsletter-popup';
 return $selectors;
} );
</code></pre>
Keep <code>class</code> attributes in AI output:
<pre><code>add_filter( 'aionly_allowed_attributes', function( $attrs ) {
 $attrs[] = 'class';
 return $attrs;
} );
</code></pre>
Add a custom AI crawler signature:
<pre><code>add_filter( 'aionly_ai_crawler_signatures', function( $sigs ) {
 $sigs[] = 'FutureBot';
 return $sigs;
} );
</code></pre>
Restrict to specific post types:
<pre><code>add_filter( 'aionly_supported_post_types', function( $types ) {
 return [ 'post', 'page' ]; // Only posts and pages.
} );
</code></pre>
Disable Token Diet on a specific post (always wins, priority 10 > settings priority 5):
<pre><code>add_filter( 'aionly_should_clean_output', function( $enabled, $post ) {
 if ( 42 === $post->ID ) {
 return false; // Post 42 serves full HTML to AI bots.
 }
 return $enabled;
}, 10, 2 );
</code></pre>
Read a single setting value in custom code:
<pre><code>$token_diet_on = '1' === \AIOnly\Pages\Settings::get( 'token_diet_enabled' );
$all_settings = \AIOnly\Pages\Settings::get_settings(); // Full array.
</code></pre>

AI-Only Pages

Mark any page as AI-only. Hidden from search engines, optimized for AI crawlers, listed in /llms-index.txt. Includes Token Diet and global settings.

Kyle Gilman

This plugin does one thing and one thing only. It adds the text <code><meta name="robots" content="noindex"></code> to the header of any password-protected post. Google and all other respectable search engines will leave your password-protected pages out of their search results.

Noindex Password-Protected Posts

Disables search-engine indexing for all password-protected posts.

AI-Only Pages vs Noindex Password-Protected Posts