Add llms.txt to Your Site
Add an llms.txt file at your site root that lists your most important pages as a clean, linkable index agents can read before they crawl your site.
What llms.txt is
llms.txt is a plain-text Markdown file served at your site root (/llms.txt) that gives AI agents a curated, linkable index of your most important pages. It was proposed by the llmstxt.org project as a discovery-and-declaration file: a human-and-machine-readable map an agent can read first, instead of guessing your structure from navigation or a sitemap. The format is ordinary Markdown — an H1 site name, an optional blockquote summary, then sections of bullet links to your key URLs, each with a short description.
Why it matters for agents
An agent has a limited context budget and pays a Cost of Retrieval for every page it fetches. llms.txt collapses discovery into a single small file: the agent reads one document and knows which pages answer which questions, in your own words, without parsing layout HTML. It is the Layer-1 declaration of the discovery dimension — the thing that lets an agent find and prioritise you before it reads or acts. A companion /llms-full.txt can inline the full text of those pages for agents that want everything in one fetch.
How to implement it
Implement llms.txt in three moves: add the artifact, point it at your content, and confirm it resolves.
- Create a Markdown file with an
H1(your site name), an optional>blockquote summary, then##sections (for example Docs, Products, Reference) of- [Title](https://example.com/page): one-line descriptionlinks. - Serve it as
text/plainortext/markdownat the exact pathhttps://yoursite/llms.txt— root only, no redirect chain. - Verify it resolves:
curl -sI https://yoursite/llms.txtreturns200and the body is valid Markdown with reachable links.
This satisfies the audit check discoverability.llms_txt — pass criterion: /llms.txt resolves 200 as Markdown with at least one valid link. This site serves its own /llms.txt as live proof. Verify field names and any format details against the primary spec at llmstxt.org at build, then verify the result with the Agent-Readiness Audit.
Related: the llms.txt spec entry · the discoverability dimension · the Agentic Web Lexicon · audit your site
