How to Validate llms.txt: A Technical Checklist
Deploying an llms.txt file is simple, but small syntax errors can prevent AI engines from parsing it. Use this checklist to audit your configuration. Check out the best checker and validator tools directory to run these checks automatically.
Key Takeaways
- Host the
llms.txtfile directly in your domain's root folder. - Configure server response headers to serve the
text/plaincontent-type. - Audit the Markdown syntax to ensure it starts with an H1 heading and uses absolute URLs.
- Use automated checking tools to run server status codes and SSL verification checks.
1. Root Location & Status Code
Ensure the file is hosted directly in your domain's root folder, served at yourdomain.com/llms.txt. Performing a request to this URL should return a 200 OK status. 301 redirects are acceptable, but avoid 404 or 503 response errors. Review how to deploy this on WordPress in our WordPress llms.txt guide.
2. Header Content-Type Verification
Confirm the server serves the file using a standard text MIME type, such as text/plain or text/markdown, with UTF-8 encoding. Serving it as text/html can cause parser failures for LLM bots. To verify your server setup, you can try our live LLMs.txt Checker tool.
LLMs.txt Critical Compliance Checklist
| Check Category | Compliance Rule | Criticality |
|---|---|---|
| MIME / Content Type | Must serve as text/plain or text/markdown |
High |
| URL Structure | All hyperlinks must be absolute (HTTPS preferred) | High |
| Markdown Title | Must begin with a single H1 header (e.g. # Title) |
High |
| Section Headings | Links must group under H2 headings (e.g. ## Sections) |
Medium |
3. The Markdown Syntax Audit
Verify that your file structure complies with the core spec:
- Verify the H1: The file must start with a level 1 heading (
# Title) to define the project name. - Ensure Absolute Links: All resources must link to absolute URLs (e.g.
https://yoursite.com/docs). Relative paths will fail validation checks. Try pasting your file text directly in our LLMs.txt Validator. - Section Divisions: Check that links are organized under H2 headers (
## Sections).
Frequently Asked Questions
You can paste your Markdown code into our free online validator at llms-txt.xyz to audit syntax compliance, link paths, and density.
The most common error is using relative paths (e.g., /docs) instead of absolute URLs (https://yoursite.com/docs).
The spec requires starting the file with a level 1 heading (# Title) to define the project name for crawler parsers.
Use our Domain Checker or check response headers via terminal commands like curl -I to confirm it serves text/plain.
Yes. While valid, HTTP is insecure. The validator recommends HTTPS connections to protect data transmission.
The checker tool verifies the HTTP status of linked assets to confirm they return a 200 OK status.
You can paste the file contents into our web validator playground to check formatting before uploading it to your server.
Not directly for traditional SEO, but clean files prevent ingestion errors, helping AI models index and cite your pages correctly. Learn more about the SEO benefits of llms.txt here.
It indicates a high ratio of links to descriptive text. Adding short explanations beneath links can improve readability for AI bots.
Yes, our tools accept domain structures with custom ports (e.g. domain.com:8080/llms.txt).