Learn / Guides / llms.txt Setup

Updated March 2026

llms.txt: The File That Tells AI How to Read Your Site

LLMs can't execute JavaScript, parse nav menus, or infer your positioning from a homepage hero. llms.txt gives them a token-efficient table of contents — structured for how models actually consume content.

What Is llms.txt?

For Humans

A markdown file at your site root (/llms.txt) that describes who you are, what you do, and where your best content lives.

For AI

A token-efficient index that lets models understand your brand in ~500 tokens instead of crawling 50 pages. Proposed by the llmstxt.org community.

When a language model encounters your brand, it has two problems: limited context windows and no ability to execute client-side JavaScript. Your beautifully designed React app? To a crawler, it's often an empty <div id="root">.

llms.txt solves this by providing a pre-rendered, structured markdown file that models can consume in a single pass. It's not a replacement for your website — it's a translation layer between your brand and the models that describe it.

What Problem It Solves

Without llms.txt

AI crawlers have token budgets. Without a curated index, they crawl your site semi-randomly — grabbing nav text, footer links, cookie banners, and maybe one or two real pages. The result: a noisy, incomplete picture of your brand.

With llms.txt

You hand the model a curated, structured summary of your brand. Identity, audience, value props, features, key pages — all in ~500 tokens. The model gets maximum signal with minimum noise.

The Template

Based on Optimly's own llms.txt structure. Copy it, replace the content with your brand's facts, upload to your root.

# Optimly

> An AI brand measurement and execution for lean marketing teams and AI-native founders.

## Identity

- **Company**: Optimly (OptimlyAI, Inc.)
- **Website**: https://optimly.ai
- **Category**: AI buyer journey and recommendation intelligence
- **Founded**: 2025
- **Headquarters**: Seattle, WA

## Audience

- Founder-led emerging brands with real customer signal and credible differentiation
- Founders who still own marketing
- Solo marketers and lean marketing teams

## Value Propositions

- Diagnose how AI models describe your brand across ChatGPT, Claude, Gemini, Perplexity
- Define your canonical brand identity for machine consumption
- Recommend owner-approved improvements to public information
- Repeat the same buyer questions to measure presence, accuracy, and preference

## Features

- [Brand Audit](https://optimly.ai/audit): Free AI brand perception analysis
- [AI Brand Index](https://optimly.ai/brand): Searchable index of 100+ brand profiles
- [AI Content Grader](https://optimly.ai/ai-content-grader): Score content for AI citability
- [AI Query Planner](https://optimly.ai/ai-query-planner): Map buyer queries to AI responses

## Key Pages

- [How It Works](https://optimly.ai/how-it-works)
- [Pricing](https://optimly.ai/pricing)
- [Case Study: Hal9](https://optimly.ai/case-studies/hal9)
- [Methodology](https://optimly.ai/resources/methodology)
- [What Is AI Brand Reputation](https://optimly.ai/what-is-ai-brand-reputation)

## Differentiation

- **Not to be confused with**: Optimly.io (LLM Observability platform)
- **Key differentiator**: Only platform focused on AI brand *reputation* — not visibility tracking or SEO

Design Decisions

Why markdown, not JSON?

Markdown is natively readable by every LLM. JSON requires parsing logic. The llmstxt.org convention chose markdown because it's the closest thing to "plain text with structure" — models can consume it directly without transformation.

JSON has its place (that's what ai-agent-manifest.json is for). But for a file designed to be read by models in their natural processing mode, markdown wins.

Why section headers matter

Section headers (## Identity, ## Features) aren't just for readability. They create semantic boundaries that models use for retrieval. When a model needs to answer "What does X do?", it can jump to the Features section without processing the whole file.

This is the same principle behind semantic chunking in RAG systems — and it's why llms-full.txt takes this even further.

Why it needs to evolve with your positioning

Most guides treat llms.txt as a "set it and forget it" file. That's a mistake. Your positioning evolves — new products, new categories, new competitors. If your llms.txt still says "analytics platform" but you've repositioned as an "intelligence platform," AI models will teach the old story.

This is exactly what Optimly's platform automates — keeping your machine-readable identity current as your brand evolves.

Common Mistakes

Treating it as a one-time file

Your llms.txt should evolve with your positioning. When you launch a new product, enter a new category, or rebrand, update the file so AI systems can retrieve current facts.

Listing every URL on your site

llms.txt is a curated index, not a sitemap. Include only your highest-value pages — the ones that define who you are. 10-15 links is better than 200.

No section structure

Without clear markdown headers (## Identity, ## Features), AI models can't efficiently parse the file. Structure is what makes llms.txt token-efficient.

Forgetting to update after positioning changes

Repositioned from 'analytics platform' to 'intelligence platform'? If your llms.txt still says analytics, that's what AI will tell your buyers.

The AI Discoverability Stack

Four files. One system. Together they make current brand information easier for AI systems to discover and retrieve. See the full series →

robots.txt — Front Door

Tells AI crawlers what they can access

llms.txt — Concierge You are here

Token-efficient index of your best content

llms-full.txt — Deep Content

RAG-ready structured content for retrieval

ai-agent-manifest.json — Identity

Machine-readable brand positioning

Next in the stack: llms-full.txt →

Implementation Checklist

  1. Step 1

    Download the llms.txt template

  2. Step 2

    Fill in your Identity section with verified company facts

  3. Step 3

    Write 3-5 value propositions (not marketing copy — plain facts)

  4. Step 4

    Curate 10-15 key pages that define your brand

  5. Step 5

    Add entity disambiguation if your name is common

  6. Step 6

    Upload to your site root at /llms.txt

  7. Step 7

    Schedule quarterly reviews to keep it current

See What AI Believes About Your Brand

Your llms.txt teaches AI who you are. But what are models actually saying right now? Search our directory to find out.

What is AI Brand Reputation? Methodology Hal9 Case Study llms.txt

Don't want to maintain these files yourself?

Claim your profile in the AI Brand Index, and we generate, maintain, and serve your entire Discoverability Stack automatically. Your llms.txt stays current. Your manifest reflects your latest positioning. Your brand-feed updates when you update your Business Profile.

All served via our agentic brand API so AI models always have your latest truth.