llms.txt: what it is and how findable checks it

Contents
  1. What does findable check?
  2. What goes in the file?
  3. How do you write a useful one?
  4. What are the limits?
  5. Key takeaways

llms.txt is a plain text file in Markdown that sits at the root of your site. It gives an AI tool a short map: who you are, and which pages matter most.

What does findable check?

One Site check, llms-txt. It fetches /llms.txt from the origin of the page you scanned and passes when the response status is 200. The hosted API reads at most the first 512 KB; the CLI reads up to 10 MB. It does not judge the content.

The check is unscored and runs with the -site flag or the site option in the API. See robots.txt and AI crawlers for the other Site checks.

What goes in the file?

A title, a one-line summary in a blockquote, and lists of links with a short note on each. This is the shape findable uses for its own file:

# Example Co

> Example Co sells hand-made ceramic mugs and ships worldwide.

## Pages

- [Shop](https://example.com/shop): every mug we sell, with sizes and prices
- [Shipping](https://example.com/shipping): countries, costs and delivery times
- [Care guide](https://example.com/care): how to wash and store a mug

## Optional

- [Full text](https://example.com/llms-full.txt): every page described in full

How do you write a useful one?

  1. Open with a summary that states what you do in one sentence.
  2. List the pages you would want quoted, not every page.
  3. Describe each link in plain words. The note is the part a model reads.
  4. Use absolute URLs.
  5. Keep the file current. Regenerate it when pages change, or build it from your page list.

What are the limits?

Nothing here guarantees that an AI tool will cite you. A page still has to be crawlable, answerable and trustworthy. The answer shape matters more: see every AEO check and every GEO check.

Key takeaways

FAQ

Is llms.txt a standard?
No. It is a proposal. Not every AI tool reads it, and findable does not claim it raises citations.
What does the llms-txt check test?
Only that /llms.txt on your site's origin returns a 200 response. It does not grade the content.
Does llms.txt replace robots.txt or sitemap.xml?
No. robots.txt controls crawler access. sitemap.xml lists URLs for search engines. llms.txt is a short human-readable guide for language models.
Where does the file go?
At the root of the host, for example https://example.com/llms.txt. A file in a subfolder is not found.

How does findable score a page?

FamilyWeightQuestion it asks
SEO50%Can crawlers read and index this page?
AEO25%Is it easy to lift an answer from this page?
GEO25%Does the page give a generative model a reason to cite it?

The hosted audit waits up to 10 s for a page and fetches at most 5 MB. It reads robots.txt and llms.txt up to 512 KB each.

More guides

Every findable AEO Check ID and How to Fix It
All 35 AEO checks in findable explained, from aeo_faq to aeo_summary. See what each id tests, how loose the test is and how to fix it. AEO is 25% of the score.
Canonical Tags and Duplicate Content: How to Get Them Right
Use one canonical link per page that points to its own absolute URL. Learn the checks canonical, canonical_self and canonical_absolute and fix them.
FAQ Schema for Answer Engines: Markup and Checks
How to add FAQPage JSON-LD that answer engines can lift, and how findable tests aeo_faq, aeo_faq_count and faq_valid. Includes a working example.
Get Findable in 15 Minutes: A Step by Step Checklist
Install findable, audit a page and your site, fix the top failures, then add MCP, the web UI, the API and a CI gate. Every step has a copy-paste command.
Every findable GEO Check ID, Plus AI Crawler Checks
All 27 GEO checks in findable explained, plus the unscored Site checks for GPTBot, ClaudeBot and llms.txt. GEO is 25% of the score. Fixes included.
Image Alt Text, Dimensions and Lazy Loading Explained
Fix img_alt, img_dimensions, img_alt_quality, img_lazy_loading and img_modern_format. See what each image check in findable tests and how to pass.
JSON-LD Schema Basics: What findable Checks and Why
Learn what JSON-LD is, which schema.org types findable validates, and how to fix jsonld_valid, jsonld_context and empty or relative values.
How to Write a Meta Description That Passes findable
Write a meta description of 120 to 160 characters, one per page, that matches the page. See the checks desc_exists, desc_length and desc_single.
Open Graph and Twitter Cards: Fix Your Share Previews
Add og:title, og:description, og:image, og:url and twitter:card so links unfurl well. See every social check findable runs and how to pass it.
robots.txt and AI Crawlers: GPTBot, ClaudeBot, PerplexityBot
How robots.txt rules decide whether GPTBot, ClaudeBot, PerplexityBot and Google-Extended can fetch your page, and how findable tests each one.
Every findable SEO Check ID and How to Fix It
A plain guide to all 98 SEO checks in findable, from title_length to csp. See what each id tests, when it passes and the fix. SEO is 50% of your score.
SEO vs AEO vs GEO: The Difference in Plain Words
SEO, AEO and GEO each target a different reader: a search crawler, an answer box, or a generative AI model. See what wins in each and how to check them.
Why AI Answer Engines Skip Your Site and How to Fix It
ChatGPT, Perplexity and Claude may ignore your pages for five fixable reasons, from robots.txt blocks to missing answers. Learn each cause and its check id.