In short
A minimal llms.txt file has a title line starting with one hash, a one-paragraph summary starting with a greater-than sign, and sections starting with two hashes that list links with a short note each. Only the title is required by the proposal at llmstxt.org. Real files from llmstxt.org, Stripe and Anthropic all follow the title rule but differ a lot after it, from 10 lines to more than 800. A good file is short, true and kept in step with the pages it describes.
An llms.txt example, line by line
Below is a complete llms.txt file for a made-up company, Example Bakery Supplies, which sells ovens to small bakeries. The company and every line of the file are invented to show the format.
Because this page is not a code editor, the file is shown as a table. Each row is one line of the file. The second column names the character the line begins with, and the third gives the text that follows it. Blank lines are left out of the table, but the file needs one between each part.
| Line | Starts with | Text after it | Part |
|---|---|---|---|
| 1 | One hash and a space (#) | Example Bakery Supplies | Title, the only required part |
| 2 | A greater-than sign and a space (>) | Example Bakery Supplies sells deck ovens and mixers to small bakeries in the United States. Prices start at $4,200 including delivery. | Summary |
| 3 | Nothing | We do not sell to home bakers. Every price on this site is in US dollars before sales tax. | Details |
| 4 | Two hashes and a space (##) | Products | A link section |
| 5 | A dash and a space (-) | A link to the deck ovens page, with a note | Link |
| 6 | A dash and a space (-) | A link to the mixers page, with a note | Link |
| 7 | Two hashes and a space (##) | Help | A link section |
| 8 | A dash and a space (-) | A link to the delivery page, with a note | Link |
| 9 | Two hashes and a space (##) | Optional | The optional section |
| 10 | A dash and a space (-) | A link to the company history page, with a note | Link |
Read top to bottom, the file answers three questions in order. What is this site? What does it sell, to whom, and for how much? Where do I go for each topic? An AI tool that reads only the first five lines already has the facts most buyers ask about.
One link line, in three parts
Every link line has the same three parts on one line: a name in square brackets, an address in round brackets straight after it, and an optional note after a colon. The line begins with a dash and a space, like an ordinary Markdown list.
| Name, in square brackets | Address, in round brackets | Note, after a colon and a space |
|---|---|---|
| [Deck ovens] | (https://example.com/ovens.md) | Sizes, loaves per hour and prices for each model. |
| [Mixers] | (https://example.com/mixers.md) | Spiral and planetary mixers, with bowl sizes. |
| [Delivery] | (https://example.com/delivery.md) | Where we deliver and how long it takes. |
| [Our history] | (https://example.com/history.md) | How the company started. |
The addresses end in .md because the proposal suggests offering a clean Markdown copy of each page at the same address with .md added. That is optional. A link to the ordinary page works too, and many real files do just that.
The rules each line follows
The proposal at llmstxt.org sets out the parts in a fixed order, and only the title is required. Everything else is a recommendation.
- The title comes first: one hash, a space, and the name of the site or project.
- A summary may follow as a quoted paragraph, starting with a greater-than sign. It should hold the key facts needed to understand the rest.
- Any number of plain paragraphs or lists may follow, with no headings. This is where details and caveats go.
- Then any number of sections, each opened by a second-level heading with two hashes, each holding a list of links.
- A section headed Optional may come last, for links a reader can skip.
The Optional section changed meaning in version 2 of the proposal, published in August 2026. The changes page says it is still allowed and still a useful convention for secondary links, but it no longer tells any tool what to leave out. Version 2 also lets a page point to its llms.txt file with a standard link tag, and lets a file in a folder cover only the pages in that folder.
The summary line does the most work. If a tool reads only one line after the title, make it the one that says what you sell, to whom and for how much.
Adapting the example to your kind of site
The shape stays the same for any site; what changes is which facts go in the summary and which pages earn a section. The table gives a starting point for four common kinds of site.
| Kind of site | The summary should say | Sections worth listing |
|---|---|---|
| Software product | What it does, who it is for, and the starting price | Features, Pricing, Comparisons, Help |
| Online shop | What you sell, where you ship, and the price range | Categories, Delivery, Returns |
| Local service | What you do, which area you cover, and how to book | Services, Areas, Prices, Contact |
| Developer documentation | What the product is and which languages it supports | Quickstart, Guides, API reference |
The proposal sets no length limit. A useful test is whether a person could read the whole file in two minutes and come away knowing what you do. If the file has grown into a full index of every page, a short llms.txt pointing to a few key sections will serve a reader better.
The details paragraph is the place for the facts people get wrong. If buyers often think you sell to consumers when you sell only to businesses, say so there in one plain sentence. It is the kind of fact a reader can easily miss when it is spread across several pages.
Three real llms.txt files, compared
Real files follow the title rule and then go their own way. The three below were fetched on 10 October 2026, and each is public.
| llmstxt.org | Stripe documentation | Anthropic developer docs | |
|---|---|---|---|
| Address | llmstxt.org/llms.txt | docs.stripe.com/llms.txt | platform.claude.com/llms.txt |
| Title line | llms.txt | Stripe Documentation | Anthropic Developer Documentation |
| Summary as a quoted paragraph | Yes | No. It opens with plain paragraphs of instructions | No. It opens with a plain sentence |
| Second-level sections | 1, headed Docs | 26, mostly by product | 3, with the English links under smaller headings |
| Lines | 10 | 710 | 832 |
| Link lines | 3 | 455 | 762 |
| Links point to Markdown copies | Yes | Yes | Yes |
Counts were made by downloading each file and counting its lines, and the lines that begin with a dash and a square bracket.
The llmstxt.org file is the cleanest model. Its summary says, in one sentence, that it is a proposal to add a /llms.txt file to websites, and that the file is Markdown giving background and links to more detailed Markdown files. Its one section lists three links, each with a note.
Stripe's file shows a different use. Its opening paragraphs are instructions to coding agents, such as checking the package registry for the latest version of Stripe's library rather than relying on a remembered version number. It even has a section headed Instructions for Large Language Model Agents. For a developer tool, the file is a place to steer the agents that write code against it.
Anthropic's file is mostly an index. It lists 762 links to English documentation pages, and names eleven other languages with a pointer to the website instead. Where it adds a note, it puts it after a spaced hyphen rather than a colon, which is a small departure from the proposal. It is useful to an agent looking for one page and too long to read as a summary.
Mistakes to avoid
Most problems with llms.txt files are the ordinary problems of any document: it is wrong, it is out of date, or it cannot be fetched. Five are worth checking for.
- A summary that does not say what you sell. A line of brand language tells a tool nothing it can repeat.
- Facts that disagree with your pages. An old price in llms.txt is worse than no llms.txt, because a tool that reads it gets the wrong figure.
- Links to pages that have moved. Every link should open, and ideally lead to text rather than a page built only with scripts.
- A file that cannot be fetched. Chrome's Lighthouse audit flags a page when a server error occurs while fetching the file.
- Expecting it to replace robots.txt. An llms.txt file cannot block or admit a crawler; only robots.txt does that.
The first two mistakes have one cure: build the file from the same source as your pages, so a price changes in one place. The Lighthouse point comes from its llms.txt audit page, which also says a missing file is marked not applicable rather than failed. The last point matters more than the file itself. Our page on AI crawler access explains which crawlers to let in.
How to check your own llms.txt file
A five-minute check catches nearly every problem above. You need a browser and, if you like, the command line.
- Open yoursite.com/llms.txt in a browser. It should show plain text, not a web page or an error.
- Check that the first line is one hash, a space and your name, with nothing before it.
- Read the summary and ask whether a stranger would know what you sell, to whom and for how much.
- Open every link and confirm it loads the page the note describes.
- Compare each price, plan name and product name with the live page that states it.
- Run Lighthouse in Chrome on your home page and read the llms.txt result in the agentic browsing section, which Google marks as experimental.
The file can be served as plain text or as Markdown. On 10 October 2026, llmstxt.org served its own file as text/plain and Stripe served its file as text/markdown, so either works in practice.
What the file will and will not do
An llms.txt file helps a tool that chooses to read it, and there is no public evidence that the main assistants read it before deciding whom to name. Treat it as tidy housekeeping, not as a way to be recommended.
Google's guide to optimizing for generative AI says Google Search ignores such files and that they neither help nor harm a site. An Ahrefs study of 137,210 domains found that 97 per cent of the llms.txt files it saw got no requests in May 2026. Our companion post, what is llms.txt, goes through that evidence in full.
SEO audit tools fetched llms.txt files more often than any kind of AI tool.
Share of all requests to llms.txt files in May 2026, by who sent them: about 22,000 requests to the roughly 1,100 domains whose file was fetched at all. Humans sent the remaining 4%.
- SEO audit tools21.7%
- Other and unidentified14.9%
- General web crawlers13.1%
- Tech profiling tools11.6%
- AI agents10.5%
- GEO and AEO tools5.8%
- AI training crawlers5.3%
- llms.txt catalogue bots3.6%
- Service and social bots2.9%
- Research bots2.7%
- AI assistants2.5%
- AI retrieval bots1.1%
How we measured this
This guide was written on 10 October 2026. The format rules come from the llms.txt proposal and its changes page at llmstxt.org. The three real files were downloaded that day from llmstxt.org, docs.stripe.com and platform.claude.com, and their lines and link lines were counted with standard command-line tools. The Lighthouse, Google and Ahrefs points come from their own pages, read the same day. The target phrase was checked in Google autocomplete the same day.
Example Bakery Supplies and its file are invented. The real files will change after this date, so the counts are a snapshot. The guide does not measure whether any assistant reads llms.txt files, and it shows no results from any scan.
Questions
What does an llms.txt file look like?
A title line starting with one hash, a summary starting with a greater-than sign, and sections starting with two hashes that list links in Markdown, each with a short note.
What is the format of llms.txt?
It is Markdown in a fixed order: title, quoted summary, optional details, then link sections, with an optional section last. Only the title is required.
Where do I put the llms.txt file?
At the root of your site, so it opens at yoursite.com/llms.txt. Version 2 of the proposal also allows a file in a folder that covers only the pages in that folder.
Do the links in llms.txt have to point to .md files?
No. The proposal suggests offering Markdown copies of pages, but a link to the ordinary page is allowed and is common in real files.
Is there an llms.txt generator?
Some documentation platforms generate the file automatically, as llmstxt.org notes. For a small site, writing it by hand from your own pages takes less time and is easier to keep accurate.
Sources
- llmstxt.org, the llms.txt proposal, read 10 October 2026
- llmstxt.org, changes in version 2, read 10 October 2026
- llmstxt.org, its own llms.txt file, read 10 October 2026
- Stripe, llms.txt for its documentation, read 10 October 2026
- Anthropic, llms.txt for its developer documentation, read 10 October 2026
- Chrome for Developers, Lighthouse llms.txt audit, read 10 October 2026
- Google Search Central, optimizing for generative AI features, read 10 October 2026
- Ahrefs, We analyzed 137K sites: 97% of llms.txt files never get read, read 10 October 2026