SEOIndustry Guide13 min readPublished June 24, 2026

Two Google teams · zero ranking impact · 0.3% top-site adoption

Google Says llms.txt Does Nothing for Rankings

On June 15, 2026 Google updated its AI optimization guide to state plainly that llms.txt has no effect — positive or negative — on Search rankings or AI Overviews. Five weeks earlier Chrome Lighthouse 13.3 started auditing the same file by default. Both are true at once, because they answer different questions.

DA
Digital Applied Team
Senior strategists · Published Jun 24, 2026
PublishedJun 24, 2026
Read time13 min
SourcesGoogle docs + Chrome + studies
Ranking impact in Google Search
None
confirmed June 15, 2026
Lighthouse result if file is absent
N/A
not a fail — a 404 is fine
Top-1,000 site adoption
0.3%
3 of 1,000 (Rankability)
Lighthouse audit areas
4
llms.txt · WebMCP · a11y · CLS

Google says llms.txt does nothing for your Search rankings, and on June 15, 2026 it wrote that down in its official documentation. The same week, every site owner who runs a Chrome Lighthouse report started seeing an llms.txt audit appear automatically. The two facts look like a contradiction, and a lot of SEO coverage has treated it as one — but it is not.

The reason both can be true is that they come from two different Google product teams pointed at two different futures. Google Search ranks crawlable HTML and openly ignores llms.txt. Chrome’s Lighthouse measures whether a site is ready for AI agents to browse it — a separate question with a separate answer. The file is relevant to one and invisible to the other.

This guide separates the two cleanly. We cover exactly what Google said and quoted it; why Chrome audits a file Search ignores; who actually reads your llms.txt today versus who skips it; and a site-type decision table so you know whether to build the file or spend the hour elsewhere. The short version: build it for the AI coding assistants that genuinely consume it, and skip it if your only goal is Google Search visibility.

Key takeaways
  1. 01
    Google Search ignores llms.txt — officially, since June 15.Google updated its AI optimization guide to add a 'Clarifying guidance on llms.txt files' section stating the file has no effect, positive or negative, on Search rankings or AI Overviews. It was a clarification of long-standing practice, not a policy change.
  2. 02
    Chrome Lighthouse 13.3 audits llms.txt — for agents, not rankings.Lighthouse 13.3.0 (May 7, 2026) moved its Agentic Browsing category into the default config, so every report now includes an llms.txt check. It measures agent readiness, which is a different mission from Search ranking.
  3. 03
    An absent file is N/A in the audit, not a failure.The Lighthouse llms.txt audit returns Not Applicable when the file is missing (404), passes when it exists and is well-formed, and only fails when the server throws an error fetching it. Nobody is penalized for not having one.
  4. 04
    AI crawlers skip llms.txt; AI coding assistants read it.A study of 500M+ LLM bot events found search crawlers almost never fetch /llms.txt. By contrast Cursor, GitHub Copilot, Continue, and Aider actively read it on documentation sites. The answer to 'does it work?' depends entirely on which AI you mean.
  5. 05
    Build it for developer docs and SDKs; skip it for most other sites.Adoption is overwhelmingly developer-facing — Anthropic, Stripe, Cloudflare, Vercel, Supabase. For e-commerce, publishers, and local businesses chasing Google visibility, foundational SEO comes first; llms.txt is optional at best.

01The Official WordWhat Google actually said on June 15.

Google published its first official AI optimization guide on May 15, 2026, titled “Optimizing your website for generative AI features on Google Search,” filed under a new Generative AI fundamentals section of Search Central. One month later, on June 15, it added a dedicated subsection —€” “Clarifying guidance on llms.txt files” —€” after, in Google’s own framing, questions from the community made it clear that misinformation was circulating.

The wording is unusually direct for Google. The guide tells site owners they do not need to produce special machine-readable files to appear in Search, and then specifically addresses people who keep an llms.txt anyway: maintaining the file is fine, but it neither helps nor harms Google visibility, because Search ignores it. That is the whole ruling. There is no nuance to read between the lines.

Google's exact wording — AI optimization guide, June 15, 2026

“You don’t need to create new machine readable files, AI text files, markup, or Markdown to appear in Google Search (including its generative AI capabilities), as Google Search itself doesn’t use them.” And, on keeping the file anyway: “It’s completely fine if you decide to create and maintain LLMS.txt files (or other similar files) for other services or systems that use these files, but doing so won’t harm (nor help) your visibility or rankings in Google Search, as Google Search ignores them.”

Two things are worth holding onto here. First, this was not a policy change — Google has never used llms.txt as a ranking input, so nothing flipped overnight. The update is retroactive context-setting: a correction of an industry misunderstanding that had been sold, in places, as a must-have. Second, the same guide reaffirms that the foundations have not moved. Google explicitly debunked a cluster of so-called AI SEO hacks — content chunking, exact-keyword obsession, artificial brand mentions — and landed on a blunt summary that answer engine and generative engine optimization are still, at bottom, SEO.

02The Apparent ContradictionSo why is Chrome auditing a file Search ignores?

Here is the source of the confusion. On May 7, 2026, Chrome Lighthouse 13.3.0 promoted its “Agentic Browsing” audit category from experimental into the default configuration. From that release on, anyone running a standard Lighthouse report — and shortly after, PageSpeed Insights and Chrome DevTools — gets agent-readiness signals automatically, including a check for whether an llms.txt file exists. No opt-in required.

That timing is what made it look like Google was quietly endorsing llms.txt as a ranking factor right as Search documentation said the opposite. The Agentic Browsing category does not evaluate ranking at all. It evaluates four distinct areas of how ready a page is for an AI agent to operate it.

Area 01
llms.txt presence and quality
1

Checks whether the file exists, is accessible, and follows the spec — an H1 title, an optional summary blockquote, and H2-sectioned links. Thin or link-less files are flagged as low quality.

Agent navigation aid
Area 02
WebMCP protocol integration
2

Checks whether the site exposes structured tool contracts agents can call directly, instead of forcing them to scrape and click their way through the DOM.

Google's actual bet
Area 03
Agent-centric accessibility
3

Validates programmatic names, role validity, and the accessibility tree — the same semantics screen readers use, which agents reuse to understand a page.

Reuses a11y semantics
Area 04
Cumulative Layout Shift
4

Penalizes sudden layout shifts that confuse an agent mid-task, the same way they frustrate human users. A stability signal, not a ranking one.

Stability for agents

Notice what is missing from that list: any notion of search ranking. Lighthouse is a developer diagnostic tool. Its Agentic Browsing category is, in effect, a readiness checklist for a future where people delegate browsing to AI agents — and llms.txt is one item on that checklist because it can help an agent orient quickly. That has no bearing on how Google Search crawls and ranks your pages today.

03Two MissionsOne company, two different futures.

The cleanest way to resolve the apparent contradiction is to stop treating “Google” as a single actor. Google Chrome and Google Search are separate product teams with separate missions and separate systems. Chrome’s Lighthouse audits agentic readiness for a world where users browse through AI agents. Google Search runs its own independent crawl and ranking pipeline, which has never consulted llms.txt and, per the June 15 documentation, still does not. The file is relevant to one team and invisible to the other.

Jeremy Howard — co-founder of Answer.AI and fast.ai — proposed llms.txt on September 3, 2024, and his original framing supports this split. The spec was never designed to help systems discover content. It was designed for inference: to give an AI a curated, LLM-friendly map of a site at the moment a user is actively asking about it.

Our expectation is that llms.txt will mainly be useful for inference, i.e. at the time a user is seeking assistance, as opposed to for training.— Jeremy Howard, creator of llms.txt, co-founder Answer.AI

Read that intent against the two missions and the design makes sense. A file built to help an assistant answer a question well, at the moment of asking, maps neatly onto Chrome’s agent-readiness audit. It maps onto nothing in Search’s discovery-and-ranking job, which is exactly why Search ignores it. The standard was never an SEO mechanism in the first place — it got recast as one by an ecosystem hungry for the next ranking lever.

04The Structural FlawWhy this rhymes with the keywords meta tag.

John Mueller, a Google Search Advocate, gave the most useful frame for why Search will not use llms.txt: he compared it to the keywords meta tag — the self-reported signal search engines abandoned over a decade ago. The reason is the same in both eras. A signal that site operators write about their own site cannot be trusted as a way to tell good sites from bad ones, because operators are not objective about their own quality.

You're telling these systems, like, I have the best website ever...by design, [they] can't trust what is here as a way of differentiating between different websites.— John Mueller, Google Search Advocate

Mueller also drew the discovery boundary explicitly. The foundational first step — how a system finds a website at all — stays bound to crawlable HTML, not to supplementary text files an operator can author at will. A self-described navigation file simply does not sit anywhere in that pipeline.

He has been careful, though, not to call the file useless. On developer-documentation sites, where AI coding assistants already know the site and just need help navigating it, an llms.txt can make genuine sense. For non-developer sites, in his view, it does not. That distinction — discovery versus functionality, ranking versus navigation — is the line the rest of this guide turns into an actionable decision.

The historical rhyme

The keywords meta tag died because operators stuffed it with terms they wished they ranked for. An llms.txt that says “here are my most important pages” carries the same self-reporting bias. That is structural, not a bug Google could patch — which is why Search ruling it out is unlikely to reverse.

05The Consumption RealityWho actually reads your llms.txt.

“Does llms.txt work?” is the wrong question because it assumes “AI” is one thing. It is not. The AI systems that might touch your file behave very differently, and the gap between them is the entire story. The table below maps the real landscape against what each system actually does with the file — and whether any of it moves Google rankings.

AI systems compared by whether they read llms.txt automatically, what they do with the file, when it matters, and any Google Search ranking impact, as of June 24, 2026.
AI systemReads llms.txt automaticallyWhat it does with the fileGoogle ranking impact
Crawlers — skip the file
Google Search crawlerNoCrawls and ranks HTML directly; the file is ignored entirely.None — confirmed June 15, 2026
AI search crawlersNo (almost never)GPTBot, ClaudeBot, PerplexityBot, OAI-SearchBot and Google-Extended overwhelmingly skip /llms.txt and crawl HTML.None
Assistants & tools — actually use it
AI coding assistantsYes (when pointed at the site)Cursor, GitHub Copilot, Continue and Aider fetch and use the file to navigate documentation sites.None (not a search context)
RAG / retrieval frameworksConditionalLangChain, Llama Index and similar pipelines can fetch llms-full.txt when explicitly configured to ingest a site.None
Chat assistants on requestConditionalChatGPT or Claude.ai may fetch the file when a user asks a question and the assistant browses your site to answer.None
Chrome Lighthouse 13.3Yes (audits for it)Reports presence and quality as an agent-readiness signal — N/A if absent, fail only on a server error.None — a dev tool, not Search

The pivot is right there in the two group headers. Crawlers — the systems that feed search and AI answers — almost never read the file; an analysis of more than 500 million LLM bot traffic events found they skip /llms.txt and crawl HTML directly. Coding assistants and on-demand retrieval, by contrast, genuinely use it. Mintlify’s internal data even indicates agents reach for llms-full.txt at over twice the rate of the standard file. So the file works — for the second group, on documentation, and nowhere near Google rankings.

The numbers, in context

Crawler-behavior and adoption figures here come from vendor studies — an Ahrefs analysis of 500M+ bot events and Mintlify’s internal agent data. They are directionally consistent across multiple SEO publications, but treat the precise percentages as indicative rather than audited. The directional finding — crawlers skip, coding assistants consume — is what holds.

06The DecisionBuild it or skip it — by site type.

Generic “should you use llms.txt?” advice is useless because the answer is entirely site-dependent. The table below collapses Mueller’s developer-versus-non-developer distinction, the crawler-versus-assistant data, and Google’s foundational-SEO-first guidance into one decision matrix. The Lighthouse column is the same for every row — an absent file is N/A, never a penalty — so the real call is whether the AI audience that reads the file is one you care about reaching.

Build-versus-skip recommendation for llms.txt across six site types, with the primary AI audience, build recommendation, and priority relative to other AEO work.
Site typePrimary AI audience that reads itBuild recommendationPriority vs other AEO work
Clear yes — developer-facing
Developer docs / API referenceCursor, Copilot, Continue, Aider, RAG pipelinesYesHigh — assistants actively navigate your docs.
Developer-facing SaaS (with SDK)Coding assistants in-IDE; RAG ingestionYesHigh — keep it lean; large files waste agent context.
Optional — limited assistant audience
General B2B SaaS (no public API)Occasional on-request chat assistant fetchesOptionalLow — do it only after foundational SEO is solid.
Skip — chase Search visibility instead
E-commerceEffectively none for ranking — crawlers skip itNoNone — invest in structured data and product feeds.
Content publisher / blogEffectively none for ranking — crawlers skip itNoNone — crawlable HTML and topical authority win citations.
Local business / SMBEffectively none for ranking — crawlers skip itNoNone — local SEO and reviews matter far more.

The adoption data backs the table’s shape. A Rankability scan of the top 1,000 most-visited global sites found just three llms.txt files — about 0.3% — with no implementation on Google, Facebook, or Amazon. A broader SE Ranking study of 300,000 domains reported around 10% adoption, nearly uniform across traffic tiers and driven largely by developer platforms and speculation. The named early adopters tell the same story: Anthropic, Stripe, Cloudflare, Vercel, Supabase, Pinecone, LangChain — developer infrastructure, almost without exception. If your site is not in that family, the file is not where your AEO hour should go. If you do decide to build one, it pays to get the surrounding plumbing right — see our markdown-first content architecture and the llms.txt spec for how to structure the file, and the complete reference for robots.txt and meta robots directives for the crawl-control rules it sits beside. If you want help drawing that line for your own stack, our agentic SEO engagements start with exactly this kind of triage.

07The Audit, PreciselyWhat Lighthouse actually checks.

If you do run the Lighthouse audit, it helps to know precisely what it grades — because the loudest misreading is that Lighthouse now penalizes sites without an llms.txt. It does not. The audit uses a three-state result, and an absent file is the neutral state, not a failure. Crucially, the whole Agentic Browsing category does not produce a weighted 0–100 score the way Performance or Accessibility do; the spec team chose pass/fail signals and fractional counts on purpose, because the standards for the agentic web are still emerging and the goal right now is actionable data, not a verdict.

Lighthouse llms.txt audit · the three-state result

Source: Chrome for Developers — llms.txt audit docs
File exists and well-formedH1 title · summary · H2-sectioned links · accessible
PASS
File absent (404)The file is optional — not having one is fine
N/A
Present but low qualityMissing H1, too short, or contains no links
FLAG
Server error on requestThe only state that actually fails the audit
FAIL

Read the bars carefully and the design intent is obvious. The only way to fail is to misconfigure your server so it throws an error when the file is requested — a genuine bug worth fixing regardless of llms.txt. Simply not having the file is N/A, because the file is currently optional. And if you do publish one, quality matters: the audit flags files that lack an H1, are too short, or contain no links, so a token file you never maintain can read as low quality.

Without this file, agents may spend more time crawling the site to understand its high-level structure and primary content.— Chrome team, llms.txt Lighthouse audit documentation

That single line is the honest case for the file, stated by the team that built the audit. It is about agent efficiency — saving a browsing AI the work of reverse-engineering your structure — not about ranking. Which is precisely why the audit lives in Chrome’s diagnostic tooling and not in Google Search’s ranking systems.

08The Forward BetWhat Google is really betting on.

Here is the signal most llms.txt coverage misses while it argues about a text file. The second item in Lighthouse’s Agentic Browsing audit is WebMCP — the Web Model Context Protocol — and that, not llms.txt, is where Google is putting its weight for agent-to-website interaction. WebMCP was announced in Chrome Canary in February 2026, featured at Google I/O 2026, and is running an origin trial in Chrome 149. It lets a site declare structured tool contracts in HTML attributes or JavaScript so an agent can act on a live session directly, instead of scraping the DOM or driving the UI with screenshots.

The difference in approach matters. llms.txt is a static map an agent reads to orient itself; WebMCP is a live interface an agent calls to get things done. One describes a site; the other lets an agent operate it. If the agentic web plays out the way Chrome is provisioning for, a structured action layer beats a flat description file — which is part of why llms.txt sits as one modest item on the audit while WebMCP anchors the next one.

Today, for Search
Foundational SEO first

Google's June 15 guidance is explicit: AEO and GEO are still SEO. Crawlable HTML, topical authority, and structured data are what earn visibility in Search and AI Overviews. No text file substitutes for that.

Do this now
Today, for assistants
llms.txt — only if you ship docs

Publish a lean, spec-compliant llms.txt if you run developer documentation or an SDK that coding assistants navigate. Keep it small; oversized files like Vercel's novel-length llms-full.txt waste agent context.

Conditional build
The horizon
Watch WebMCP, not the text file

WebMCP is the structured action layer Google is provisioning for the agentic web. It is early — an origin trial in Chrome 149 — but it is the standard worth tracking if agent interaction is on your roadmap.

Track, don't rush

Our read of the next 12 months: the llms.txt debate fades as Google’s documentation settles the ranking question, and the real action moves to structured agent interfaces. WebMCP’s vendor-reported preview numbers — sharply fewer errors and better task completion than screenshot-based automation, plus large token-efficiency gains — are early and not independently audited, so we would not bank a roadmap on them yet. But the direction is clear enough that teams building for an agentic future should learn WebMCP now and treat llms.txt as the minor, optional artifact Google has just confirmed it to be. For more on the broader shift, see our guide to answer engine optimization in 2026, and the robots.txt vs llms.txt decision matrix for AI crawlers for how these files fit alongside your crawl-control setup.

09ConclusionThe contradiction that wasn’t.

The verdict, June 2026

llms.txt is an agent-discovery aid, not a ranking signal — and the two were never the same job.

The headline reads like a contradiction — Google says llms.txt does nothing for rankings, yet Chrome audits it — but it dissolves the moment you separate the two teams. Google Search ignores the file and said so plainly on June 15. Chrome Lighthouse audits it because it measures agent readiness, a different question with a different answer. Nothing about either statement is in tension once you stop treating “Google” as one voice.

So the practical guidance is not “llms.txt is useless.” It has a legitimate use: developer documentation and SDK sites whose audience includes coding assistants like Cursor and Copilot that actively read it. Build a lean, spec-compliant file there. For e-commerce, publishers, local businesses, and anyone whose goal is Google Search visibility, skip it and put the time into the foundations Google says still decide everything — crawlable HTML, topical authority, and structured data.

The deeper lesson is older than this file. A signal you write about your own site cannot be trusted to rank it; that is why the keywords meta tag died and why llms.txt will not become a ranking lever. The forward bet worth watching is not the text file at all — it is the structured action layer, WebMCP, that lets agents do things on your site rather than just read about it. Optimize for the AI that actually reaches your audience, and let the rest be the optional artifact it is.

Cut through the AI-SEO noise

Stop chasing the latest AI-SEO file and build what actually ranks.

We help businesses separate real AI-search signal from vendor hype — building the crawlable foundations, structured data, and agent-readiness that actually move visibility, scoped to your site type and goals.

Free consultationExpert guidanceTailored solutions
What we work on

AI-search visibility engagements

  • AEO and GEO audits grounded in Google's own guidance
  • llms.txt build-or-skip triage by site type
  • Structured data and crawlable-HTML foundations
  • Agent-readiness reviews — Lighthouse, WebMCP, accessibility
  • AI citation tracking across ChatGPT, Claude, and AI Overviews
FAQ · Google llms.txt and Lighthouse

The questions we get every week.

No. On June 15, 2026 Google updated its AI optimization guide with a 'Clarifying guidance on llms.txt files' section stating the file has no effect — positive or negative — on Google Search rankings or AI Overviews, because Google Search does not use it. This was a clarification of long-standing practice rather than a policy change; Google has never used llms.txt as a ranking input. The guide also reaffirmed that the same foundational SEO principles apply to AI Overviews and AI Mode, debunking 'AI SEO hacks' like content chunking and exact-keyword obsession. If Search visibility is your goal, llms.txt is not where to spend effort.