Complete Guide to llms.txt: The AI Crawler Navigation File
When the web standardized robots.txt in 1994, it gave webmasters a way to communicate with automated crawlers , telling them what they could and couldn't access. For 30 years, that standard has governed how search engine bots navigate the web.
Now a new type of automated system needs similar guidance: large language models and AI assistants that crawl the web to retrieve context, build knowledge bases, and generate cited answers. robots.txt was not designed for this use case. It handles access control, not content guidance. It tells crawlers whether they can visit a page , not what the page is about, which pages are most authoritative, or how the AI system should interpret the content it finds.
llms.txt fills that gap. It is a plain-text file placed at the root of your domain that provides AI systems with structured guidance about your site's content, purpose, and authority structure. Think of it as a welcome packet for AI crawlers , one that helps them understand your site the way a librarian card catalog helps a researcher understand what a library contains.
This guide covers everything: what llms.txt is, why it matters for your AI visibility, the exact format specification, step-by-step creation instructions, and how to generate one without writing it manually.
What Is llms.txt?
llms.txt is an open standard proposed by Jeremy Howard (fast.ai) in September 2024. It is a Markdown-formatted plain-text file hosted at https://yourdomain.com/llms.txt that provides AI language model crawlers with a structured overview of your site's content.
The analogy to robots.txt is useful but imperfect:
robots.txt | llms.txt | |
|---|---|---|
| Purpose | Access control | Content guidance |
| Format | Custom directive syntax | Markdown |
| Primary audience | All web crawlers | LLM / AI crawlers |
| What it does | Allows/blocks crawler access | Describes site purpose, structure, authoritative pages |
| Mandatory | No (but widely respected) | No (but increasingly read) |
| Location | /robots.txt | /llms.txt |
While robots.txt says "you may or may not access these URLs," llms.txt says "here is what this site is about, here are our most important pages, here is the context you need to understand and cite our content accurately."
The Problem llms.txt Solves
AI systems that retrieve information from the web face a fundamental challenge: they encounter a domain they've never visited before and need to quickly understand:
- What does this organization do?
- What are the most authoritative pages on this domain?
- How is the content organized?
- What is this domain's area of expertise?
- Which content is current vs. outdated?
Without llms.txt, an AI crawler must infer all of this from crawling individual pages, parsing navigation menus, and making probabilistic guesses about content hierarchy. This is inefficient and error-prone. A well-crafted llms.txt eliminates the guesswork and gives the AI system exactly the orientation it needs to use your content accurately.
Why llms.txt Matters for AI Visibility
If your goal is to be cited by AI systems , ChatGPT, Perplexity, Claude, Gemini , then helping those systems understand and trust your content is a direct competitive advantage. llms.txt contributes to AI visibility in several concrete ways:
1. Directing Crawlers to Your Best Content
Without guidance, AI crawlers may waste their crawl budget on low-value pages (legal disclaimers, old archive pages, duplicate content) and miss your highest-quality, most citeable content. llms.txt lets you proactively list your most authoritative pages so crawlers prioritize them.
2. Establishing Topical Authority
The description section of llms.txt lets you define what your site's area of expertise is in plain language. This helps AI systems correctly categorize your domain and route queries in your area to your content.
3. Providing Context for Accurate Citations
When an AI system cites your content, it needs to accurately represent who you are and what your content says. An llms.txt file with a clear organization description and content summary reduces the probability of the AI misattributing or miscontextualizing your content.
4. Signaling Content Freshness and Status
You can use llms.txt to distinguish between current content and archived or deprecated content , a capability that robots.txt does not provide and that XML sitemaps only partially address.
5. Competitive Differentiation
Adoption of llms.txt is still relatively low. The domains that implement it well today are establishing an early-mover advantage in AI visibility that will compound as AI search traffic grows.
The llms.txt Format Specification
The llms.txt format is intentionally simple. It is a Markdown file with a defined structure, not a complex configuration syntax. Any text editor can create one.
File Structure Overview
# [Site/Organization Name]
> [One-to-three sentence description of the site's purpose and area of expertise]
[Optional additional context paragraphs in Markdown]
## [Section Name]
- [Page Title]: [URL] , [brief description]
- [Page Title]: [URL] , [brief description]
## [Another Section Name]
- [Page Title]: [URL] , [brief description]
Required Elements
1. H1 Title (required) The H1 should be your organization name or site name. This is the first thing AI systems read and forms the basis for entity recognition.
# AY Rank
2. Blockquote Description (required)
Immediately after the H1, a Markdown blockquote (>) provides a concise description of your site's purpose and expertise. This should be 1–3 sentences. It is the single most important field in the file.
> AY Rank is a GEO (Generative Engine Optimization) agency that helps brands get cited by AI search engines including ChatGPT, Perplexity, Gemini, and Google AI Overviews. We provide SEO and GEO audits, structured data tools, entity optimization, and strategic consulting for AI-era search visibility.
Optional Elements
3. Extended Description (optional) After the blockquote, you can include additional Markdown prose providing more context , your founding year, geographic focus, methodologies, notable clients (with permission), or areas of specialty.
4. Linked Content Sections (optional but highly recommended) H2-level sections followed by Markdown link lists are the primary mechanism for directing AI crawlers to your best content. Each link follows the format:
- [Page Title](https://yourdomain.com/page-slug): Brief description of what the page covers
You can have multiple H2 sections organizing content by type (services, guides, tools, case studies, etc.).
5. Optional Sections Marker
The spec allows you to mark a section as optional using an ## Optional heading or by appending [optional] to section headings. Content in optional sections is deprioritized , crawlers may skip it if processing time is limited.
Step-by-Step: How to Create Your llms.txt
Step 1: Define Your Site Description
Write 2–3 sentences that capture:
- What your organization does
- Who you serve
- What makes your content authoritative
Avoid marketing language. Write for a machine that is trying to decide whether to cite you as an expert on a specific topic. Be specific about your area of expertise.
Weak: "Company X is a leading provider of digital marketing solutions for businesses of all sizes."
Strong: "Company X publishes technical SEO and content strategy research for mid-market e-commerce brands. Our data is based on analysis of 5,000+ sites across 12 industry verticals and is updated quarterly."
Step 2: Inventory Your Most Authoritative Content
Make a list of your most important, citeable pages. Aim for 20–50 pages maximum. Prioritize:
- Your most comprehensive guides and pillar content
- Pages that contain original data, research, or statistics
- Pages that define your area of expertise
- Pages that frequently rank for important target queries
- Tools or resources that others reference and link to
Do NOT include:
- Legal pages (Terms of Service, Privacy Policy)
- Admin or account pages
- Low-quality archive content
- Pages with thin or duplicate content
- URL patterns that are programmatically generated at scale without unique value
Step 3: Organize Content Into Logical Sections
Group your content list into 3–6 categories using H2 headings. Common section structures:
For a media/publication site:
## Featured Articles
## Data & Research
## Guides
## Tools
For a SaaS company:
## Product Documentation
## Case Studies
## Blog
## API Reference
For a service business:
## Services
## Guides & Resources
## Case Studies
## About
Step 4: Write the File
Assemble the sections into a single Markdown file. Keep descriptions per link to one sentence , clear, factual, and specific about what the page contains.
Example snippet:
# AY Rank > AY Rank is a GEO (Generative Engine Optimization) agency specializing in helping brands achieve citations in AI search engines including ChatGPT, Perplexity, Gemini, and Google AI Overviews. We combine technical SEO expertise with AI-era optimization strategies including entity optimization, structured data implementation, and content architecture for machine-readable authority. Founded in 2024, AY Rank works with B2B SaaS companies, e-commerce brands, and professional services firms seeking visibility in the AI search landscape. ## Services - [GEO Optimization](https://ayrank.com/geo): Generative Engine Optimization service , audit, strategy, and implementation for AI search citation across all major platforms. - [AI Visibility Checker](https://ayrank.com/tools/ai-visibility-checker): Free tool to check how visible your brand is across ChatGPT, Perplexity, Gemini, and Google AI Overviews. - [Schema Generator](https://ayrank.com/tools/schema-generator): Free JSON-LD schema markup generator for Article, FAQPage, HowTo, Organization, and more. ## Guides - [How to Get Cited by AI Search Engines](https://ayrank.com/blog/how-to-get-cited-by-ai-search-engines): Complete guide to 10 strategies for earning citations across ChatGPT, Perplexity, Gemini, and AI Overviews. - [How to Optimize for Google AI Overviews](https://ayrank.com/blog/how-to-optimize-for-google-ai-overviews): Detailed guide to the 8 optimization strategies for appearing in AI Overview citations. - [Complete Guide to llms.txt](https://ayrank.com/blog/complete-guide-to-llms-txt): This guide , everything you need to know about the llms.txt standard.
Step 5: Deploy the File
- Save the file as
llms.txt(plain text, UTF-8 encoding) - Upload to the root of your web server, accessible at
https://yourdomain.com/llms.txt - Verify accessibility: open
https://yourdomain.com/llms.txtin a browser , it should display as plain text - Ensure the server returns a
200status code (not a redirect) - Set the
Content-Typeheader totext/plain(most servers do this automatically for.txtfiles)
Step 6: Verify and Test
- Visit
https://yourdomain.com/llms.txtin a private/incognito browser window - Check that all links in the file are live and return 200 status codes
- Validate the Markdown formatting renders correctly
- Submit the URL in Google Search Console's URL Inspection tool to prompt indexing
For the fastest possible deployment with automatic formatting validation, use our llms.txt Generator , enter your site details and it produces a correctly formatted, deployment-ready file in under 2 minutes.
What to Include and What to Omit
Include
- Your highest-authority, most comprehensive content pieces
- Original research, data, and statistics pages
- Pillar guides and definitive reference content
- Tool and resource pages
- Pages that define your expertise area
- Your about page (with clear organization description)
Omit
- Privacy policy, Terms of Service, cookie policy pages
- Redirect URLs or vanity URLs that forward to other pages
- Paginated archive pages (
/blog?page=2) - Search result pages and filter pages
- User-generated content pages with low editorial control
- Any page you would not want an AI to cite as authoritative
- Outdated content that no longer reflects your current views
A Note on Length
Keep llms.txt under 2,000 lines. AI crawlers process it as context, and extremely long files may exceed context window limits or be truncated. If you have a very large site, be selective , 30 excellent entries outperform 300 mediocre ones.
Which AI Systems Use llms.txt?
As of 2026, llms.txt adoption is growing among AI systems:
| AI System | llms.txt Support | Notes |
|---|---|---|
| Perplexity | Active support | PerplexityBot reads llms.txt when present |
| Anthropic (Claude) | Active support | ClaudeBot respects the file |
| OpenAI (ChatGPT) | Emerging | GPTBot testing support |
| Google (Gemini/AI Overviews) | Under development | Not confirmed but llms.txt signals align with Google's content quality direction |
| You.com | Partial support | Reads but implementation varies |
| Cohere | Emerging | Research-grade support |
Adoption will accelerate as the standard matures and AI search becomes more commercially important. Implementing llms.txt now ensures you capture the benefit as each new AI system adds support, without any additional work on your part.
Advanced llms.txt Techniques
Content Freshness Signaling
You can annotate links with freshness metadata using Markdown comments or bracketed labels:
- [2026 GEO Benchmark Report](https://example.com/geo-benchmark-2026): Annual survey of AI citation rates across 500 B2B domains. Published January 2026.
Explicit dates in link descriptions help AI systems prioritize fresh content over older entries in the same file.
Topical Cluster Signaling
Group related content together under topic-specific H2 sections rather than a generic "Blog" or "Articles" bucket. This helps AI systems understand the topical relationships between your pages:
## Entity Optimization - [Entity Optimization Guide]: ... - [How to Build a Knowledge Panel]: ... - [Structured Data for Entities]: ... ## Content Structure for AI - [Content Chunking Guide]: ... - [FAQPage Schema Guide]: ...
llms-full.txt for Comprehensive Content
The spec also defines an optional companion file: llms-full.txt. While llms.txt provides links and brief descriptions, llms-full.txt contains the full text of your most important pages in a single file, optimized for AI systems that process content in bulk rather than crawling individual URLs.
llms-full.txt is particularly useful for:
- Documentation sites where comprehensive content is more valuable than selective linking
- Sites targeting AI assistants that use retrieval-augmented generation (RAG)
- Publishers who want to enable AI systems to access their full text
Generate both files automatically with our llms.txt Generator.
Coordination With robots.txt
Your llms.txt and robots.txt should be consistent. If you block an AI crawler in robots.txt, your llms.txt has no effect for that crawler. If you want AI crawlers to access your content:
- Ensure
robots.txtdoes not blockGPTBot,PerplexityBot,ClaudeBot,anthropic-ai,Google-Extended, orBytespider - If you want to allow AI crawlers but block traditional scrapers, you can allow specific AI user agents while using a more restrictive default
Disallow
User-agent: GPTBot
Allow: /
User-agent: PerplexityBot
Allow: /
User-agent: ClaudeBot
Allow: /
User-agent: *
Disallow: /private/
Real-World llms.txt Examples
Minimal Valid llms.txt
# Acme Analytics > Acme Analytics provides web analytics software and educational resources for data-driven marketers. Our blog covers analytics strategy, conversion optimization, and data interpretation for marketing teams. ## Key Resources - [Analytics Setup Guide](https://acmeanalytics.com/guides/setup): Step-by-step guide to implementing Acme Analytics on any website. - [Conversion Rate Benchmarks 2026](https://acmeanalytics.com/data/conversion-benchmarks-2026): Industry benchmark data across 12 verticals based on 10,000+ site analysis. - [About Acme Analytics](https://acmeanalytics.com/about): Company background, methodology, and team.
Comprehensive llms.txt (Recommended Structure)
# Acme Analytics > Acme Analytics is a web analytics platform and research publisher serving 8,000+ marketing teams. We publish original research on conversion optimization, user behavior analysis, and marketing attribution. Our data is sourced from opt-in aggregated data across our customer base and independently verified. Founded in 2019. Headquartered in San Francisco. SOC 2 Type II certified. ## Product - [Acme Analytics Platform](https://acmeanalytics.com/product): Core web analytics product , session recording, funnel analysis, A/B testing, attribution. - [Integrations](https://acmeanalytics.com/integrations): 150+ integrations with CRM, advertising, and e-commerce platforms. - [Pricing](https://acmeanalytics.com/pricing): Transparent pricing tiers for startups through enterprise. ## Research & Data - [Conversion Rate Benchmarks 2026](https://acmeanalytics.com/data/conversion-benchmarks-2026): Annual benchmark report covering 12 industry verticals, 10,000+ sites. Published January 2026. - [Mobile vs Desktop Conversion Study](https://acmeanalytics.com/research/mobile-desktop-2025): Analysis of 500M sessions comparing conversion patterns across device types. ## Guides - [Complete Analytics Setup Guide](https://acmeanalytics.com/guides/setup): End-to-end implementation guide for technical and non-technical users. - [Attribution Modeling Explained](https://acmeanalytics.com/guides/attribution): Comparison of attribution models (last-click, first-click, linear, data-driven) with use-case guidance. ## About - [About Acme Analytics](https://acmeanalytics.com/about): Company background, team, methodology, and research standards. - [Press Coverage](https://acmeanalytics.com/press): Third-party coverage in TechCrunch, Forbes, Marketing Week. ## Optional - [Blog Archive](https://acmeanalytics.com/blog): Full archive of 300+ articles on analytics and conversion optimization.
Maintaining Your llms.txt
llms.txt is not a one-time task , it needs maintenance as your site evolves:
Quarterly review tasks:
- Add new high-quality content published in the quarter
- Remove or update links to pages that have been significantly changed or deprecated
- Update the description if your service offering has evolved
- Verify all links return 200 status codes (dead links in
llms.txtsignal poor site maintenance)
When to update immediately:
- After publishing major guides, research, or tool pages
- After significant site restructuring or URL changes
- After launching new products or service areas
Frequently Asked Questions
Is llms.txt an official standard?
llms.txt is an open, community-driven standard proposed by Jeremy Howard (fast.ai) in 2024. It is not an official W3C or IETF standard, but it has been adopted by a growing number of AI systems and has significant momentum in the AI/SEO community.
Will llms.txt hurt my SEO if I implement it incorrectly?
No. llms.txt is a plain text file that traditional search engine bots (Googlebot, Bingbot) do not process as a ranking signal. Implementing it incorrectly at worst means AI crawlers ignore it , it cannot negatively affect your traditional search rankings.
How is llms.txt different from an XML sitemap?
An XML sitemap tells crawlers which URLs exist on your site. llms.txt tells AI systems what your site is about, which pages are most authoritative, and how to understand your content's purpose. They serve complementary functions and you should have both.
Does llms.txt replace robots.txt?
No. robots.txt controls crawler access. llms.txt provides content guidance. You need both. They serve different purposes for different use cases.
How quickly will AI systems pick up my llms.txt after I publish it?
PerplexityBot and ClaudeBot typically crawl new llms.txt files within days to weeks of publication. You can accelerate this by submitting the URL to Google Search Console (for Googlebot indexing) and directly fetching the URL through Perplexity's search to signal the new content.
Can I include competitor brand names in my llms.txt?
No. llms.txt should describe your own site only. Including competitor names or unrelated keywords is a misuse of the format and will be ignored or flagged by AI systems.
What is the maximum size for llms.txt?
There is no official maximum, but best practice is to keep it under 2,000 lines. AI systems process llms.txt as part of their context window during crawl sessions; excessively large files may be truncated or processed inefficiently.
Ready to create your llms.txt? Our llms.txt Generator walks you through every field, validates your Markdown formatting, checks that all your URLs are live, and produces a deployment-ready file in under 2 minutes. No manual file editing required.
This post is part of our Technical SEO guide. Related reading: Best Schema Markup Generators, Best GEO Agency for E-commerce, GEO for SaaS.

Abdelmoghit drives the content engine at AY Rank. He researches keywords, plans content clusters, and produces citation-optimized articles that rank in both Google and AI search engines.
Full Bio →


