Skip to content

DISC-002Find

llms.txt present and non-trivial

Checks that you publish an llms.txt file at the root of your site with a title, at least 20 lines and links that work.

What we check

We request /llms.txt and read it as Markdown: we count non-blank lines, look for an H1 heading (a line starting with "# "), and check that its first five links resolve. llms.txt is a community proposal (llmstxt.org, version 2, 2026-08-10), not a ratified standard: an H1, a short blockquote summary, then H2 sections listing key pages as "- [name](url): note".

Why it matters

llms.txt gives an AI assistant a short, curated map of your shop: what you sell and where your catalogue, shipping, returns and contact pages are, so it can reach them without crawling the whole site. Support varies between AI providers, and Google has stated it ignores llms.txt, so treat it as a low-cost addition.

How we check

FAIL: the response is not HTTP 200, or its first 300 characters contain an <html tag (a storefront page served for an unknown path). PASS: at least 20 non-blank lines, an H1, at least one Markdown link with an https:// or root-relative target, and all of the first five links resolving. Links on your domain are requested and must answer below HTTP 400; links elsewhere are counted as resolving without a request. WARN: the file exists but misses a condition. SKIPPED: our request was refused before your server answered, or bot management answered instead of your shop.

How to fix it

  1. Serve a file at https://your-domain/llms.txt with HTTP 200 and a text/markdown or text/plain content type.
  2. Start with an H1 with the shop name, then a one-paragraph blockquote summary.
  3. Add H2 sections listing catalogue, shipping, returns and contact pages as "- [name](url): note", reaching at least 20 non-blank lines.
  4. Use absolute or root-relative URLs and check every linked page on your domain loads.
  5. If your platform does not let you place files at the root, check your platform's settings or apps; a custom-built shop can serve it as a static file.

What good looks like

# Example Shop

> Example Shop sells linen clothing and bedding, shipped from Lisbon to the EU and UK.

## Catalogue
- [All products](https://www.example-shop.com/collections/all): full catalogue
- [Shirts](https://www.example-shop.com/collections/shirts): men's and women's shirts
- [Bedding](https://www.example-shop.com/collections/bedding): sheets and duvet covers
- [Gift cards](https://www.example-shop.com/products/gift-card): digital gift cards

## Policies
- [Shipping](https://www.example-shop.com/policies/shipping-policy): costs and delivery times
- [Returns](https://www.example-shop.com/policies/refund-policy): 30-day returns
- [Terms](https://www.example-shop.com/policies/terms-of-service): terms of sale

## Help
- [Contact](https://www.example-shop.com/pages/contact): email and phone
- [Size guide](https://www.example-shop.com/pages/size-guide): measurements
- [FAQ](https://www.example-shop.com/pages/faq): common questions

## Company
- [About](https://www.example-shop.com/pages/about): who we are
- [Care](https://www.example-shop.com/pages/care): washing linen

## Optional
- [Blog](https://www.example-shop.com/blogs/news): articles

Sources