For the complete documentation index, see llms.txt. Every page on this site is also served as Markdown: append `.md` to any URL, or send `Accept: text/markdown`.
Skip to content

The AI crawler guide: bots, jobs and robots.txt · chapter 5

Is llms.txt worth publishing?

llms.txt is a proposed Markdown file at a site's root that gives AI agents a summary and links to its best pages. Some agents read it, but no major operator documents using it to decide what to crawl or cite, and Google says its AI features need none. Publish one, but do not expect it to move answers.

7 days free · card required

Perplexity answers citing llms-full.txt
6
2 and 3 Oct only
ChatGPT answers citing it
0
30 days
questions it was cited on, both branded
2 of 61
61 tracked questions
Analyst agentAnalystattensira.com workspace, citation timeline read over the Attensira MCP on 2026-10-05 · to
Karl-Gustav KallasmaaKarl-Gustav Kallasmaa, Founder & CEO

Last updated

Key facts

What happened when we published an llms.txt?

One engine read it, and cited it. Attensira publishes an llms.txt file and a longer llms-full.txt at the root of attensira.com. When Perplexity answered questions about us by name on 2 and 3 October 2026, some of its answers listed attensira.com/llms-full.txt among their sources, next to our home page, our about page and our documentation. The count is at the top of this page; we read every one of those answers verbatim over the Attensira MCP.

So the file is not invisible. At least one engine fetched it, read it and treated it as a source about us.

Three things temper that.

It was only for our branded questions. Perplexity cited the file when asked about Attensira by name, and ChatGPT never cited it. Neither engine cited it on the unbranded category questions we track, where we were named in no answers in the month.

It did not fix what the answers said. The same answers described us partly in older positioning lifted from other pages. Having a clean summary available did not stop the engine using older sentences elsewhere.

Ours is too big. Size matters for a file whose purpose is to fit in a model's context, and the proposal's whole idea is a concise file. When we measured ours on 4 October 2026 it had grown into an index of the site; the sizes are further down this page.

That is the honest summary of llms.txt as of October 2026: cheap, read by some agents, cited by at least one, and not documented by any major operator as an input to what it crawls or cites.

What is llms.txt?

A proposal, not a standard. Jeremy Howard published it on 3 September 2024 at llmstxt.org, "to standardise on using an /llms.txt file to provide information to help agents use a website".

The motivation is practical. A web page built for people carries navigation, scripts, banners and layout that an agent has to strip away to find the content, and a whole site rarely fits in a model's context. A short Markdown file at a known address, written for agents, solves both: it says what the site is and points at the pages worth reading, in plain text.

It is not a crawler control. The proposal says it is meant to coexist with robots.txt and sitemaps. robots.txt says who may fetch what. A sitemap lists every page. llms.txt is a curated reading list.

What goes in the file?

The proposal defines a small, fixed shape, in this order:

  1. An H1 with the site's name. The only required element.
  2. A blockquote with a short summary, the key facts an agent needs to understand everything after it.
  3. Optional paragraphs or lists with more detail.
  4. H2 sections of links, each link a Markdown link with an optional note after a colon.
  5. An "Optional" section for secondary links an agent can skip when its context is tight.

A minimal file for a fictional company:

plain text
# Ledgerly

> Ledgerly is invoicing software for agencies of 5 to 50 people. It sends
> invoices from tracked time, chases late payments and syncs to Xero.

## Product
- [Pricing](https://ledgerly.example/pricing.md): plans and what each includes
- [How it works](https://ledgerly.example/how-it-works.md): from time entry to paid invoice

## Docs
- [Xero integration](https://ledgerly.example/docs/xero.md): setup and sync rules

## Optional
- [Changelog](https://ledgerly.example/changelog.md)

The proposal also suggests offering clean Markdown versions of pages at the same URL with .md added, so the links can point at text rather than HTML. Attensira serves one for every page; attensira.com/pricing.md returns the pricing page as Markdown.

Do AI crawlers read llms.txt?

Some agents fetch it. No major operator documents using it.

None of the crawler documentation from OpenAI, Anthropic, Perplexity, Google, Apple, Amazon or Meta that we reviewed for this guide says the operator reads llms.txt or uses it to decide what to crawl, index or cite. Google goes further: it says you do not need to create new machine-readable files, AI text files or markup to appear in its AI features.

That leaves direct evidence, and the evidence is thin and mixed. Perplexity citing our llms-full.txt shows that at least one engine's retrieval can surface the file as a source. It does not show the file changed what was said. Documentation publishers such as Mistral serve one, so agents working with their docs have a clean entry point.

So: treat it as a convenience for agents that look for it, not as a lever.

What did the engine take from the file it cited?

One of the six answers, verbatim. llms-full.txt sat second in its sources. The audience line still came from our home page, in wording we had already retired: a file that is read is not a file that is followed.

Answer · Perplexityasked

Question: what is Attensira

Perplexity answered: Attensira is an AI-search visibility and optimization platform. You tell it where you want your brand to be cited (e.g., by ChatGPT, Claude, Perplexity, and Google AI), and it figures out why you’re missing and helps create fixes (like opening a pull request or CMS draft) for approval. … It’s aimed at B2B SaaS/technical teams whose site/docs live in a Git repo, and also teams using a modern CMS.

Sources cited

  1. 1attensira.com (Attensira)
  2. 2attensira.com/llms-full.txt (Attensira)
  3. 3docs.attensira.com
  4. 4g2.com
  5. 5pitchwall.co
  6. 6linkedin.com

NamedAttensira is in this Perplexity answer.

attensira.com workspace, Attensira MCP · · sample 2 of 3 that day

Is it worth publishing one?

Yes, for most sites, as long as you are clear about why.

It is cheap. If your pages come from structured content, generating the file is a few lines of code. If not, a hand-written file of twenty links takes an hour.

It is harmless. It does not block, redirect or change anything else.

It helps the agents that use it. Coding assistants and research agents that look for it get a clean summary instead of scraping your navigation.

It forces a useful exercise. Writing the blockquote, two or three sentences that say what you are and for whom, is the same exercise as writing the passage you want AI answers to quote. If you cannot write it, your home page probably does not say it either.

What it is not worth is time taken from the work that does move answers: letting search agents in, writing passages that stand alone, and earning a place on the third-party pages that decide your category.

How should you write a good one?

Five rules, most of which we broke with our own file.

  1. Lead with a blockquote that would make a good answer. Name, category, who it is for, the one thing that sets you apart. This is the part most likely to be quoted.
  2. Keep it short. Tens of links, not hundreds. Put everything secondary under "Optional".
  3. Link to Markdown where you can. The point is to spare the agent the HTML.
  4. Keep it in sync with the site. Generate it from the same source as your pages, or review it whenever positioning changes. A stale llms.txt is a stale passage at a well-known address.
  5. Do not put anything in it you would not put on the page. Content written only for bots, or instructions aimed at models, is a risk with no documented benefit.

The llms.txt generator drafts a file in the proposal's format from your site.

How far had our own file drifted from a summary?

Our two files as we measured them. The proposal asks for a concise map an agent can hold in context; ours had become a full index of the site, and the full version is larger still.

attensira.com/llms.txt
131 KB
130,827 bytes
links in it, across 30 sections
644
one file
attensira.com/llms-full.txt
161 KB
161,436 bytes
attensira.com/llms.txt and llms-full.txt, fetched and measured on 2026-10-04 ·

What does a good summary blockquote look like?

Ours is a fair example of the content and a poor example of the length. It opens: "Attensira is an AI-native SEO agency run by software: the service of an SEO agency at the price of a tool." It then says who the crew is, which engines it reads, what kinds of work it ships, who it is for, and how approval works.

Everything in it is a sentence we would be glad to see quoted, and each sentence names us, so it survives being lifted alone. Its weakness is that it runs to well over a hundred words before the first link. A tighter version would keep the first sentence, add one sentence on what the crew does and one on who it is for, and move the rest into the linked pages. That is the shape to aim for: three sentences an engine could use as the whole answer to "what is this company?".

Write yours the same way you would write the answer block at the top of your home page: plain words, your name in every sentence, no claims you cannot back. If the two disagree, fix whichever is out of date.

How can you tell whether agents read your file?

Look in two places.

Your server or edge logs. Filter requests for /llms.txt and any companion files, and group them by user agent. Agents that request it by name are agents that look for it. Remember that the user agent is self-reported; the verification chapter shows how to check it.

The answers. Track a branded question such as "what is [your company]" on each engine and read which sources the answers attach. That is how we saw Perplexity citing our llms-full.txt. If the file never appears as a source and nothing in the answers echoes its summary, it is not doing much, and that is fine for a file that costs so little.

What neither place can tell you is whether the file changed an answer. For that you would need a before-and-after on the same questions, with the file as the only change, which almost nobody has run, ourselves included. If you run one, publish the result either way.

What should you do instead, or as well?

If the goal is to be named and cited in AI answers, three pieces of work matter more than any file:

  • Allow the search and user agents of the engines you care about in robots.txt. The robots.txt chapter shows how.
  • Serve your answers in the HTML, readable without JavaScript, with passages that name you and stand alone.
  • Be accurately present on the third-party pages engines already cite for your buyers' questions.

Publish an llms.txt alongside that work. Just do not count it as the work.

The last chapter of this guide, what to allow and what to block, brings the access decisions together.

What else do people ask?

What is llms.txt?
A proposal, published by Jeremy Howard on 3 September 2024, for a Markdown file at /llms.txt that helps agents use a website. It has one required element, an H1 with the site's name, followed by a short blockquote summary and optional sections of links to the pages most worth reading.
Does ChatGPT or Google read llms.txt?
Neither OpenAI's nor Google's crawler documentation says it reads llms.txt, and Google says its AI features need no AI text files. Some agents do fetch it: Perplexity cited our own llms-full.txt as a source in answers about us in October 2026. Reading it is not the same as being influenced by it.
Does llms.txt replace robots.txt?
No, and the proposal says it is meant to coexist with existing standards. robots.txt says which crawlers may fetch which paths. llms.txt is a curated reading list for agents. A crawler blocked by robots.txt is not let in by llms.txt, and an llms.txt does not block anything.
How long should an llms.txt file be?
Short enough to fit comfortably in a model's context window, which is the point of the format. The proposal puts secondary links in an optional section that agents can skip. Ours had grown to about 130 KB and 644 links when we checked it, closer to a full index than a summary.
Should every page also have a Markdown version?
The proposal suggests offering clean Markdown versions of pages at the same URL with .md added. It is useful for agents that prefer plain text, and cheap if your pages are generated from structured content. Like llms.txt itself, it has no documented effect on citations.

Where do these facts come from?

5 sources, 9 statements: each statement with the page it came from and the day it was checked.

  1. The llms.txt proposal, published by Jeremy Howard on 3 September 2024, proposes standardising on an /llms.txt file to provide information to help agents use a website.

    llmstxt.org · retrieved

  2. The llms.txt proposal requires an H1 with the project or site name as the only mandatory section, followed by a blockquote summary, optional detail, and zero or more H2-delimited file lists of Markdown links, with an Optional section for secondary information agents can skip.

    llmstxt.org · retrieved

  3. The llms.txt proposal suggests sites provide a clean Markdown version of pages at the same URL with .md appended.

    llmstxt.org · retrieved

  4. The llms.txt proposal describes the file as coexisting with robots.txt and sitemaps rather than replacing them.

    llmstxt.org · retrieved

  5. Google states that site owners do not need to create new machine-readable files, AI text files or markup to appear in its AI features.

    developers.google.com · retrieved

    “You don't need to create new machine readable files, AI text files, or markup to appear in these features.”
  6. Mistral serves an llms.txt file for its documentation at docs.mistral.ai/llms.txt.

    docs.mistral.ai · retrieved

  7. Fetched 4 October 2026: attensira.com/llms.txt was 130,827 bytes with 30 H2 sections and 644 links, and attensira.com/llms-full.txt was 161,436 bytes; attensira.com serves a Markdown version of its pages, for example attensira.com/pricing.md.

    attensira.com · retrieved

  8. Read over the Attensira MCP on 4 October 2026 (attensira.com workspace): Perplexity's answers to 'what is Attensira' on 2 and 3 October 2026 cited https://www.attensira.com/llms-full.txt as a source.

    attensira.com workspace, read over the Attensira MCP on

  9. Read over the Attensira MCP on 5 October 2026 (attensira.com workspace, 4 September to 4 October 2026): attensira.com/llms-full.txt was listed as a source in 6 Perplexity answers and no ChatGPT answers, all on 2 and 3 October, 5 to 'what is Attensira' and 1 to 'Attensira reviews'.

    attensira.com workspace, read over the Attensira MCP on

Want software that does your AI-search visibility work, with you in control of every change?

7 days free · card required