Cosa contiene davvero un file llms.txt?

Un file llms.txt è un indice in Markdown semplice, collocato nella radice del sito, che elenca le pagine più importanti con brevi descrizioni, così i modelli linguistici possono trovare rapidamente i contenuti migliori. Si scrive con un titolo H1, un riassunto di una riga, sezioni H2 che raggruppano i link e una sezione facoltativa per il materiale secondario. Il formato è semplice, ma sono i dettagli a decretarne il funzionamento.

Cosa contiene davvero un file llms.txt?

Un file llms.txt contiene un titolo H1 obbligatorio, un blocco citazione di riassunto facoltativo, sezioni H2 con link Markdown e descrizioni, più una sezione facoltativa per le pagine secondarie.

La struttura segue la proposta dello scienziato dei dati Jeremy Howard, pubblicata per la prima volta il 3 settembre 2024, come riportato da Frase. Una seconda versione è arrivata nell’agosto 2026 con regole per più file, in cui il file più specifico prevale. L’unico elemento obbligatorio è l’H1 con il nome del sito o del progetto. Tutto il resto è consigliato, non richiesto.

Uno scheletro funzionante si presenta così:

• H1: nome del sito o dell’azienda (obbligatorio)
• Blocco citazione: un breve riassunto di ciò che copre il sito
• Sezioni H2: aree di contenuto raggruppate, ciascuna con link e descrizioni di una riga
• Sezione facoltativa: pagine secondarie che contano meno per un modello linguistico

Mintlify descrive la stessa struttura e sottolinea che il file deve essere Markdown puro servito come testo semplice, mai racchiuso in HTML. Questo singolo errore compromette l’analisi più spesso di qualsiasi altro.

Come costruisco un file llms.txt passo dopo passo?

Si costruisce un file llms.txt scegliendo da 10 a 30 pagine chiave, scrivendo l’H1 e il riassunto, raggruppando i link sotto intestazioni H2 e salvando il file come llms.txt nella radice del sito.

Quel numero di pagine proviene direttamente da Frase ed è un limite ragionevole: un indice esiste per indicare ciò che conta, non per rispecchiare la sitemap. La sequenza completa:

1. Scegli le 10-30 pagine più importanti per il tuo pubblico.
2. Scrivi l’H1 con il nome del sito o del progetto.
3. Aggiungi un blocco citazione di riassunto di una o due frasi.
4. Raggruppa i link sotto intestazioni H2 per argomento.
5. Sposta le pagine secondarie in una sezione Facoltativa.
6. Salva il file come llms.txt nella directory principale.
7. Aggiornalo ogni volta che pubblichi o ritiri una pagina.

La collocazione non è negoziabile. Il file risiede a un URL diretto come esempio.com/llms.txt, secondo Mintlify. GitBook segnala che puoi anche ospitarlo su /docs/llms.txt e verificarlo con un semplice controllo dell’intestazione: curl -I https://docs.esempio.com/llms.txt. Se quel comando restituisce un 200, sei online.

Cosa devo controllare prima di pubblicare il file?

Devi verificare che il file inizi con un H1, che ogni link restituisca lo stato 200 e che il file rimanga sotto i 50KB prima di pubblicarlo.

La linea guida dei 50KB e il controllo dei link provengono entrambi da Mintlify, che consiglia llms-full.txt per i contenuti completi invece di gonfiare l’indice. La validazione è il punto in cui la maggior parte dei file fallisce in silenzio, quindi scorri questo elenco:

Vale la pena nominare direttamente gli errori comuni, perché si ripetono in quasi ogni file difettoso: racchiudere il file in HTML, includere ogni URL del sito, dimenticare di aggiornarlo, usare URL relativi invece di quelli assoluti e omettere l’H1. Ognuno è facile da correggere e facile da trascurare.

Qual è la differenza tra llms.txt e llms-full.txt?

llms.txt è un breve indice di link con descrizioni, mentre llms-full.txt contiene il testo completo della documentazione in un unico file Markdown.

Mailmodo conferma che la specifica definisce questi due file distinti. GitBook aggiunge il compromesso: llms-full.txt riduce il sovraccarico di recupero perché tutto sta in una sola richiesta, ma può diventare estremamente grande per siti di documentazione estesi. llms-full.txt non fa parte della proposta principale, eppure piattaforme come Mintlify lo generano e Anthropic ne pubblica uno.

I modelli linguistici leggono davvero i file llms.txt?

I modelli linguistici attuali non scoprono automaticamente i file llms.txt, quindi devi fornire il contenuto manualmente incollandolo in un prompt o caricando il file.

Questa è la conclusione di Mailmodo, e i dati sull’adozione confermano la cautela. Ahrefs ha esaminato 137.210 domini e ha scoperto che il 97% dei file llms.txt che pubblicano ha ricevuto zero richieste a maggio 2026. Semrush ha registrato zero visite da GPTBot, ClaudeBot, PerplexityBot e Google-Extended tra metà agosto e fine ottobre 2025, sempre secondo Frase.

Google Search dichiara di non usare llms.txt, e pubblicarne uno non aiuta né danneggia il posizionamento o la visibilità. A maggio 2026, Chrome Lighthouse ha aggiunto un controllo llms.txt in una nuova sezione dedicata alla navigazione agentica, il che segnala interesse da parte degli strumenti più che dei crawler. La conclusione pratica: considera llms.txt un artefatto a basso costo e basso rischio. Pubblicalo, mantienilo accurato e non aspettarti traffico da esso oggi.

Posso generare llms.txt automaticamente invece che a mano?

Puoi generare llms.txt automaticamente tramite piattaforme che lo costruiscono a ogni deploy, oppure tramite strumenti autonomi che leggono la tua sitemap e producono il Markdown per te.

Mintlify genera e ospita /llms.txt, /llms-full.txt e le versioni .md di tutte le tue pagine automaticamente a ogni deploy. GitBook fa lo stesso per la documentazione pubblicata ed espone le versioni Markdown di ogni pagina. La generazione manuale, al contrario, richiede script per llms-full.txt e per le varianti Markdown.

Altre strade da conoscere:

• llmstxt di dotenv: costruisce il file dalla tua sitemap.xml
• llmstxt di Firecrawl: un generatore autonomo
• LLMs.txt Generator di Wordlift: inserisci l’indirizzo del sito, scegli pagine e articoli, elabora l’URL, copia il Markdown
• Hostinger WordPress: amministrazione WP, scheda Strumenti, sezione Preferenze IA, attiva l’interruttore Turn on LLMs.txt
• Hostinger AI Builder: genera il file automaticamente una volta che il sito è online

Queste opzioni provengono da Mailmodo e Hostinger. Se carichi manualmente, Hostinger segnala che la radice predefinita è /var/www/html/, raggiungibile tramite un gestore di file o SFTP. L’elenco di circa 474 aziende che hanno adottato lo standard, tra cui Mintlify, Cloudflare e Cursor, mostra che l’adozione è reale ma ancora agli inizi.

In cosa è diverso llms.txt da robots.txt?

robots.txt usa testo standard per dire ai crawler cosa possono scansionare, mentre llms.txt usa il Markdown per dire ai sistemi di intelligenza artificiale quali contenuti contano di più.

Hostinger traccia chiaramente questa distinzione, e GitBook la rafforza: llms.txt è una convenzione emergente, non uno standard web formale con uno schema fisso, e non è un file di controllo degli accessi. Non sostituisce robots.txt e non va mai trattato come un livello di autorizzazione.

Un dettaglio facoltativo da Mailmodo: puoi aggiungere l’intestazione HTTP X-Robots-Tag: llms-txt alla configurazione del server. È un segnale, non un cancello.

Domande frequenti

Dove deve andare esattamente il file llms.txt?

Colloca llms.txt nella directory principale del tuo dominio in modo che si risolva su esempio.com/llms.txt. Per i sottodomini di documentazione funziona anche /docs/llms.txt. Servilo come Markdown puro, mai racchiuso in HTML, e verifica che l’URL restituisca una risposta 200.

Quante pagine dovrei elencare in llms.txt?

Punta a 10-30 pagine che contano di più. Raggruppale sotto intestazioni H2 per argomento e sposta le pagine secondarie in una sezione Facoltativa. L’obiettivo è un indice curato, non uno specchio completo della tua sitemap.

Pubblicare llms.txt migliora il mio posizionamento su Google?

No. Google Search dichiara di non usare llms.txt, e pubblicarne uno non aiuta né danneggia il posizionamento o la visibilità. Trattalo come preparazione alle pipeline di acquisizione dei contenuti per l’IA, non come tattica di posizionamento.

Dovrei creare anche llms-full.txt?

Crealo se gestisci un sito di documentazione con contenuti sostanziosi. llms-full.txt contiene il testo completo in un unico file, il che riduce il sovraccarico di recupero, ma può diventare molto grande. Mantieni l’indice snello e lascia che il file completo porti il grosso.

Inizia in piccolo: scegli le tue pagine migliori, scrivi l’H1 e il riassunto, pubblica il file e controllalo con una richiesta di intestazione. Poi mantienilo aggiornato, perché un indice obsoleto è peggio di nessun indice. Se vuoi vedere la pipeline in azione, il nostro blog è il caso di prova pubblico.

Per approfondire

• Come scrivere una sezione FAQ che i motori AI citano realmente?
• Cosa sappiamo davvero di come Google indicizza i contenuti nel 2026?
• Cosa significa davvero “Citato dall’IA” nel 2026?
• La biografia dell’autore influisce davvero sulle citazioni AI?