Most llms.txt examples online are too generic to be useful. They show a couple of links, maybe a quickstart, maybe an auth page, and call it a day. That is fine for understanding the format. It is not enough if you are maintaining a real docs surface with multiple audiences and dozens or hundreds of pages.
The hard part is not writing the file. The hard part is deciding what shape it should take for your kind of documentation.
If you have not read the basics yet, start with What Is llms.txt? A Practical Guide for SaaS Docs Teams. This post assumes you already understand what the file is and focuses on the more useful question: what should a good one actually look like?
The Pattern Matters More Than the Syntax
The syntax is the easy part. Markdown headings and links are not the bottleneck.
The real question is this:
What job is your docs site doing for the model?
An API reference has different priorities than a help center. A developer docs portal has different priorities than a product support site. If you use the same llms.txt structure for all of them, you usually end up with something that is technically valid and editorially weak.
So instead of one universal template, it is better to think in patterns.
Pattern 1: API Docs
This is the most common case for technical SaaS products.
The model usually needs to answer one of these:
- how do I authenticate?
- what endpoint should I call?
- what are the required fields?
- how do I handle errors or rate limits?
- which SDK or integration path should I use?
That means your llms.txt should optimize for first successful requests and common implementation tasks.
Good API docs pattern
1# Acme API Docs2
3Developer documentation for Acme's REST API. Covers authentication,4endpoints, pagination, errors, webhooks, and SDKs.5
6## Start Here7
8- [Quickstart](https://docs.acme.com/quickstart): Make your first API request9- [Authentication](https://docs.acme.com/authentication): API keys, OAuth, and scopes10- [API Overview](https://docs.acme.com/api): Core resources and request model11
12## Core Tasks13
14- [Create a customer](https://docs.acme.com/customers/create)15- [List invoices](https://docs.acme.com/invoices/list)16- [Handle webhooks](https://docs.acme.com/webhooks)17
18## Operational Docs19
20- [Errors](https://docs.acme.com/errors)21- [Rate Limits](https://docs.acme.com/rate-limits)22- [Pagination](https://docs.acme.com/pagination)23
24## SDKs25
26- [Node SDK](https://docs.acme.com/sdks/node)27- [Python SDK](https://docs.acme.com/sdks/python)Why this works
- It starts with the shortest path to a successful request.
- It includes operational pages that models often need in the middle of implementation.
- It uses task-oriented grouping, not just navigation labels.
Common API docs mistake
Teams often dump top-level reference categories into llms.txt:
- Resources
- Guides
- SDKs
- Concepts
That looks organized, but it does not help the model much. It still has to guess where the good pages are.
For API docs, be opinionated. A model benefits more from Authentication, Errors, and Webhooks than from a perfectly mirrored sidebar.
Pattern 2: Help Centers
Help centers are different because the main tasks are usually diagnostic:
- why is this not working?
- where do I change a setting?
- what does this error mean?
- how do I connect this product to another one?
The best llms.txt for a help center is less about API primitives and more about common workflows, troubleshooting, and account-level tasks.
Good help center pattern
1# Acme Help Center2
3Product support documentation for Acme. Covers setup, billing, permissions,4integrations, troubleshooting, and account management.5
6## Start Here7
8- [Getting Started](https://help.acme.com/getting-started)9- [Workspace Setup](https://help.acme.com/workspace-setup)10- [Invite Teammates](https://help.acme.com/invite-teammates)11
12## Common Issues13
14- [Login Problems](https://help.acme.com/login-problems)15- [Permission Errors](https://help.acme.com/permission-errors)16- [Integration Failures](https://help.acme.com/integration-failures)17
18## Key Workflows19
20- [Billing and Invoices](https://help.acme.com/billing)21- [User Roles](https://help.acme.com/user-roles)22- [Slack Integration](https://help.acme.com/slack)Why this works
- It reflects how support questions are actually phrased.
- It prioritizes troubleshooting and configuration over product marketing structure.
- It gives the model a path into account-level problems without making it scan every page.
Common help center mistake
Many help centers organize content by internal team ownership:
- Accounts
- Workspace
- Integrations
- Billing
That may be how the docs team thinks. It is not how users or models phrase questions.
For a help center, lean toward workflows and failure modes, not internal taxonomy.
Pattern 3: Developer Docs
Developer docs usually sit somewhere between API reference and product guidance.
They often include:
- concepts
- setup guides
- architecture decisions
- CLI usage
- SDKs
- deployment or hosting instructions
The best llms.txt here should help a model build the right mental map, not just find the first endpoint.
Good developer docs pattern
1# Acme Developer Docs2
3Technical documentation for building on Acme. Covers local development,4SDK usage, CLI commands, deployment, authentication, and architecture.5
6## Start Here7
8- [Quickstart](https://developers.acme.com/quickstart)9- [Local Development](https://developers.acme.com/local-development)10- [Authentication](https://developers.acme.com/authentication)11
12## Core Concepts13
14- [Architecture Overview](https://developers.acme.com/architecture)15- [Data Model](https://developers.acme.com/data-model)16- [Environments](https://developers.acme.com/environments)17
18## Build and Ship19
20- [CLI Reference](https://developers.acme.com/cli)21- [Deployments](https://developers.acme.com/deployments)22- [Webhooks](https://developers.acme.com/webhooks)23
24## References25
26- [REST API](https://developers.acme.com/api)27- [Node SDK](https://developers.acme.com/sdks/node)28- [Python SDK](https://developers.acme.com/sdks/python)Why this works
- It gives the model both orientation and implementation paths.
- It includes concept pages when the product has architecture the model needs to understand before writing code.
- It separates references from workflows instead of flattening everything.
Common developer docs mistake
Teams often treat developer docs like pure API reference and leave out architecture pages entirely.
That works for simple APIs. It breaks down for platforms, CLIs, deployment systems, or products where the main difficulty is choosing the right path, not just calling an endpoint.
If your product has meaningful concepts, include them.
What Changes Across These Three Patterns
Here is the simplest way to think about the differences:
| Docs type | Main job of llms.txt | What to emphasize |
|---|---|---|
| API docs | first successful implementation | auth, endpoints, errors, rate limits, webhooks |
| Help center | diagnose and resolve issues | workflows, troubleshooting, permissions, billing |
| Developer docs | build the right mental model and path | concepts, setup, CLI, deployment, references |
That table is usually more useful than generic advice like "include the important pages."
Every docs team knows they should include important pages. The hard part is deciding what “important” means for the kind of surface you run.
What Not to Copy Between Patterns
This is where most llms.txt files go wrong.
People copy the same template between very different docs surfaces.
Bad examples:
- using API-centric sections like
Rate LimitsandPaginationin a help center that mostly handles account setup - using support-style troubleshooting sections as the top-level structure for developer docs
- listing architecture docs first for a simple API that mostly needs
QuickstartandAuthentication
The file should reflect the most common and most valuable agent tasks for that surface.
If it does not, the file still exists, but it is not doing much useful work.
A Good Editorial Test
Before shipping llms.txt, ask this:
If a good engineer on my team had 60 seconds to point an AI agent at the right pages, would they choose this exact list?
If the answer is no, keep editing.
That is the right standard because a good llms.txt is not just a machine-readable file. It is editorial judgment captured in a compact form.
Start Small, Then Specialize
If you are publishing your first llms.txt, do not overfit immediately.
Start with:
- one short intro
- one
Start Heresection - one or two task-oriented groups
- 10 to 20 links total
Then refine it once you see what kinds of questions your docs surface actually gets.
The biggest improvement usually comes from moving from a generic link dump to a structure that matches your docs type.
That alone makes the file much more useful.
The Next Layer
Examples are helpful, but llms.txt is still just the discovery layer.
After that, the next questions are:
- how should the file relate to
sitemap.xml? - how do you keep it updated as docs evolve?
- what else do agents need besides an index?
We will cover those separately. For the bigger systems view, read llms.txt Isn't Enough. For the basics, start with What Is llms.txt? A Practical Guide for SaaS Docs Teams.