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.

Javier Casares

Fine-grained control over how search engines index and display your WordPress content. Apply 5 independent robots directives to 25 different page contexts with flexible implementation methods.
5 Robots Directives:
<ul>
<li>noindex: Prevent search engines from indexing the page</li>
<li>nofollow: Prevent search engines from following links on the page</li>
<li>noarchive: Prevent search engines from showing cached versions</li>
<li>nosnippet: Prevent search engines from showing text snippets in results</li>
<li>noimageindex: Prevent search engines from indexing images on the page</li>
</ul>
Implementation Methods:
<ul>
<li>HTML Meta Tags: Traditional method, easy to verify in page source (default)</li>
<li>HTTP Headers: More robust, works with all content types including PDFs and images</li>
<li>Both: Maximum compatibility for all scenarios</li>
</ul>
Control Levels:
<ul>
<li>Global Settings: Apply directives to 25 different page contexts (posts, pages, archives, etc.)</li>
<li>Granular Control (Optional): Override global settings for individual posts, pages, and custom post types via meta boxes in the editor</li>
</ul>
Perfect for:
<ul>
<li>Blocking indexing of attachment pages while allowing link following</li>
<li>Preventing duplicate content issues with flexible directive combinations</li>
<li>Controlling archive page indexing with granular control</li>
<li>Managing pagination SEO with independent settings</li>
<li>Protecting private content from search engine caching</li>
<li>Preventing snippet display while still indexing content</li>
</ul>
Main pages
<ul>
<li>Front Page: Block the indexing of the site’s front page.</li>
<li>Home: Block the indexing of the site’s home page.</li>
</ul>
Pages and Posts
<ul>
<li>Page: Block the indexing of the site’s pages.</li>
<li>Privacy Policy: Block the indexing of the site’s privacy policy page.</li>
<li>Single: Block the indexing of a post on the site.</li>
<li>Singular: Block the indexing of a post or a page of the site.</li>
</ul>
Taxonomies
<ul>
<li>Category: Block the indexing of the site categories. The lists where the posts appear.</li>
<li>Tag: Block the indexing of the site’s tags. The lists where the posts appear.</li>
</ul>
Dates
<ul>
<li>Date: Block the indexing when any date-based archive page (i.e. a monthly, yearly, daily or time-based archive) of the site. The lists where the posts appear.</li>
<li>Day: Block the indexing when a daily archive of the site. The lists where the posts appear.</li>
<li>Month: Block the indexing when a monthly archive of the site. The lists where the posts appear.</li>
<li>Time: Block the indexing when an hourly, “minutely”, or “secondly” archive of the site. The lists where the posts appear.</li>
<li>Year: Block the indexing when a yearly archive of the site. The lists where the posts appear.</li>
</ul>
Archives
<ul>
<li>Archive: Block the indexing of any type of Archive page. Category, Tag, Author and Date based pages are all types of Archives. The lists where the posts appear.</li>
<li>Author: Block the indexing of the author’s page, where the author’s publications appear.</li>
<li>Post Type Archive: Block the indexing of any post type page.</li>
</ul>
Pagination
<ul>
<li>Pagination: Block the indexing of the pagination, i.e. all pages other than the main page of an archive.</li>
</ul>
Search
<ul>
<li>Search: Block the indexing of the internal search result pages.</li>
</ul>
Attachments
<ul>
<li>Attachment: Block the indexing of an attachment document to a post or page. An attachment is an image or other file uploaded through the post editor’s upload utility. Attachments can be displayed on their own “page” or template. This will not cause the indexing of the image or file to be blocked.</li>
</ul>
Previews
<ul>
<li>Customize Preview: Block the indexing when a content is being displayed in customize mode.</li>
<li>Preview: Block the indexing when a single post is being displayed in draft mode.</li>
</ul>
Error Page
<ul>
<li>Error 404: This will cause an error page to be blocked from being indexed. As it is an error page, it should not be indexed per se, but just in case.</li>
</ul>
Important note: if you have any doubt about any of the following items it is best not to activate the option as you could lose results in the search engines.
<h3>Compatibility</h3>
<ul>
<li>WordPress: 5.7 – 7.1</li>
<li>PHP: 7.2 – 8.5</li>
</ul>
<h3>Security</h3>
This plugin adheres to the following security measures and review protocols for each version:
<ul>
<li><a href="https://developer.wordpress.org/plugins/" rel="nofollow ugc">WordPress Plugin Handbook</a></li>
<li><a href="https://developer.wordpress.org/plugins/wordpress-org/plugin-security/" rel="nofollow ugc">WordPress Plugin Security</a></li>
<li><a href="https://developer.wordpress.org/apis/security/" rel="nofollow ugc">WordPress APIs Security</a></li>
<li><a href="https://github.com/WordPress/WordPress-Coding-Standards" rel="nofollow ugc">WordPress Coding Standards</a></li>
<li><a href="https://wordpress.org/plugins/plugin-check/" rel="ugc">Plugin Check (PCP)</a></li>
</ul>
<h3>Privacy</h3>
<ul>
<li>This plugin does not collect any information about your site, your identity, the plugins, themes or content the site has.</li>
</ul>
<h3>Vulnerabilities</h3>
<ul>
<li>No vulnerabilities have been published up to version 2.0.1.</li>
<li>Version 2.0.0 includes proactive security hardening based on comprehensive security audit (see docs/SECURITY-2026-01-20.md).</li>
</ul>
Found a security vulnerability? Please report it to us privately at the <a href="https://github.com/javiercasares/noindex-seo/security/advisories/new" rel="nofollow ugc">noindex SEO GitHub repository</a>.

noindex SEO

Control search engine indexing with robots directives using HTML meta tags or HTTP headers.

AI-Only Pages vs noindex SEO