llms.txt Is Now Checked by Google PageSpeed — What Webmasters Need to Know

In early May, Google's Lighthouse tool gained a brand-new audit category called "Agentic Browsing." One of its three core checks is the llms.txt file. Lighthouse now verifies whether this file exists on your site, whether it's formatted as valid Markdown, and whether it includes at least one H1-level heading.
Here's what's actually going on, where this matters in practice, and whether you should prioritize it right now.
What Is Agentic Browsing — and Why Does It Need llms.txt?
"Agentic browsing" refers to the ability of an AI system to interact with a website autonomously, without a human guiding every step. While traditional SEO is about making your site legible to ranking algorithms, agentic browsing is about something different: how easily an AI agent can extract information from your pages on its own.
llms.txt is a structured map of your site's most important pages, written specifically for language models to consume. The idea is straightforward — AI agents don't crawl a site the way Googlebot does. They grab what's easy to find and quick to process. If your key content is buried behind complex JavaScript rendering or nested menus, an agent will simply skip it.
The standard is documented at llmstxt.org. Markdown was chosen as the format because it's both machine-parseable and human-readable, making it easy to produce and maintain.
The Official Position: Proceed With Caution
Context matters here. Neither Google, OpenAI, nor Anthropic has officially confirmed that their core search or chat products use llms.txt as a ranking or retrieval signal.
In fact, Google's John Mueller publicly compared llms.txt to the old keywords meta tag — a standard that once seemed important but lost all influence after widespread abuse made it unreliable. That's a pointed comparison, and it's worth taking seriously.
So why did Google add an llms.txt audit to Lighthouse at all? Most likely, it's a proactive infrastructure move. The company appears to be normalizing new data quality standards ahead of a future where AI agents become the primary way people consume web content. The Lighthouse check is a nudge to the market — a way to encourage adoption of the format before it becomes a hard requirement. That does not mean it influences rankings today.
Where llms.txt Actually Delivers Value Right Now
While major search engines sit on the fence, llms.txt has already found real-world adoption in one important context: AI-assisted developer tooling.
Code editors with built-in AI assistance actively read llms.txt when a developer asks the AI to help with a library integration, an API, or a framework. Having a well-structured llms.txt allows the AI to instantly understand your documentation's layout and navigate directly to the relevant section, rather than wandering across the entire site.
If your site serves technical users — documentation for an API, an open-source library, a developer SDK, or a SaaS platform with integration guides — having llms.txt directly improves the experience of users who rely on AI coding tools. For that audience, it's not optional.
Should You Build One? A Practical Decision Matrix
For most commercial websites, llms.txt remains a low priority. Here's a simple way to think about it:
High priority — implement it now: Developer-facing products, technical documentation sites, API references, and SaaS platforms with integration guides. This file directly improves how AI tools interact with your docs, which affects daily user workflows.
Low priority — monitor for now: E-commerce stores and general corporate websites. There's no documented evidence that llms.txt affects search visibility or the quality of answers in mainstream AI assistants.
Medium priority — worth planning: Content publishers, media sites, and blogs. If you want your content cited more frequently as an authoritative source in AI-generated answers, this is worth putting on the roadmap — not this week, but this quarter.
From a pure technical standpoint, creating the file takes roughly ten minutes. It's a plain text document placed in your site's root directory. The harder conversation is usually with clients or stakeholders: justifying budget for a file that "nobody officially uses" is sometimes more effort than making the file itself.
How to Create a Valid llms.txt File
The format is simple. At minimum, your llms.txt must:
- Be valid Markdown
- Contain at least one H1 heading (
#) - Live at the root of your domain:
https://yourdomain.com/llms.txt
A minimal example:
# My Website
> A brief description of what this site is about and who it serves.
## Key Pages
- [Homepage](https://yourdomain.com/)
- [About](https://yourdomain.com/about/)
- [Blog](https://yourdomain.com/blog/)
## Documentation
- [Getting Started](https://yourdomain.com/docs/start/)
- [API Reference](https://yourdomain.com/docs/api/)
More complex sites can organize content into sections by topic, product area, or content type. The goal is to give an AI agent a clean, navigable summary of where the important content lives.
To verify your file passes Lighthouse's audit, you can check its Markdown syntax using any online Markdown linter before publishing.
The Bottom Line
The addition of an llms.txt audit to Google PageSpeed isn't a fire alarm. It's a directional signal about where the web is heading — from human search to machine-driven content retrieval.
For webmasters, the practical takeaway is this: start thinking about your site's information architecture not only for the user's eye, but for the AI agent's logic. You don't need to implement llms.txt across every project today. But ignoring the trend entirely is a mistake. Tracking it, testing it on pilot projects, and having a clear internal opinion on its priority is the sensible move right now.
The sites that will benefit earliest are the ones that already think carefully about structured data, clean information hierarchies, and making content easy to consume programmatically. If that describes how you build, you're already ahead of the curve — adding llms.txt is just the next small step.
Share this article
Send it to your audience or copy an AI-ready prompt.


