Il file llms.txt è un documento in formato Markdown che alcuni siti pubblicano nella root del dominio per indicare a un sistema AI quali pagine considerare prioritarie. Chi gestisce un sito, un ecommerce o un progetto di contenuti si chiede spesso se vada creato prima di investire tempo altrove, perché la promessa è ridurre il lavoro di analisi richiesto a un modello linguistico.
Che cos’è il file llms.txt e a cosa serve
Il file llms.txt è un indice testuale in Markdown, pubblicato all’indirizzo /llms.txt di un dominio, che elenca le pagine ritenute più rilevanti di un sito insieme a una breve descrizione di ciascuna. Serve a offrire a un agente AI una mappa già selezionata dei contenuti principali, evitando che debba analizzare l’intera struttura HTML per capire cosa contiene il sito.
La proposta arriva da Jeremy Howard, cofondatore di Answer.AI, ed è stata pubblicata il 3 settembre 2024 come proposta dello standard llms.txt. L’idea nasceva per un problema specifico: i modelli linguistici hanno una finestra di contesto limitata e le pagine web moderne contengono menu, banner e script che occupano spazio senza aggiungere informazioni rilevanti per rispondere a una domanda. Un file Markdown pulito riduce quel rumore.
Per un’azienda con un sito di documentazione tecnica, un ecommerce con centinaia di categorie o un blog con anni di archivio, la domanda pratica è se un assistente AI, un agente di coding o un motore di ricerca generativo consultino questo file prima di rispondere a una domanda sul brand. La risposta cambia a seconda del sistema considerato, ed è proprio questa distinzione a determinare se creare llms.txt oggi ha senso per un progetto specifico.
Nei progetti che analizziamo, il primo errore è spesso trattare llms.txt come un requisito uniforme per qualsiasi sito. La valutazione cambia molto tra una documentazione tecnica consultata da sviluppatori e un sito locale composto da poche pagine di servizio.
Google usa llms.txt?
Google Search non utilizza llms.txt per nessuna delle sue funzionalità, incluse le AI Overviews e l’AI Mode. La documentazione ufficiale precisa che i file llms.txt non sono necessari per comparire nella ricerca generativa e che pubblicarli non migliora né peggiora visibilità e posizionamento, perché Google Search li ignora.
Questa affermazione arriva dopo mesi di segnali contrastanti. Alcuni portali per sviluppatori di Google avevano mostrato un file llms.txt generato automaticamente da un aggiornamento del CMS interno, episodio che aveva alimentato la convinzione che l’azienda stesse per adottare lo standard. John Mueller, dello staff di Google Search Relations, ha chiarito che si trattava di un effetto collaterale della piattaforma di pubblicazione, paragonando llms.txt al vecchio meta tag keywords: un segnale scritto dal proprietario del sito e per questo privo di valore per un motore che deve giudicare in autonomia la rilevanza dei contenuti.
Chrome segue un percorso diverso da quello di Search. Lighthouse include un controllo dedicato a llms.txt nella categoria Agentic Browsing, insieme ad altri criteri come la stabilità del layout e l’integrità dell’albero di accessibilità. Questo controllo non riguarda il posizionamento su Google Search, ma la predisposizione di un sito a essere navigato da un browser agent, cioè un software che compie azioni autonome dentro le pagine per conto di un utente.
Per chi gestisce un sito aziendale la conseguenza pratica è distinguere due obiettivi diversi: se lo scopo è la visibilità nella ricerca Google, llms.txt non sposta nulla, mentre se lo scopo riguarda la compatibilità con agenti di navigazione o strumenti di sviluppo, il file può avere un ruolo, seppure limitato e ancora in evoluzione.
Nel confronto con i team aziendali chiarifichiamo spesso questo passaggio prima di parlare di implementazione: un file pensato per agenti e strumenti tecnici non va presentato internamente come un intervento destinato ad aumentare il ranking su Google.
Come è strutturato un file llms.txt
Un file llms.txt segue una struttura Markdown fissa composta da un titolo, una breve descrizione e sezioni organizzate per argomento, ciascuna con un elenco di link alle risorse più rilevanti del sito. La sintassi proposta è volutamente minima, per restare leggibile sia da un umano sia da un parser automatico.
Titolo, descrizione e sezioni Markdown
Il file si apre con un H1 che riporta il nome del progetto o del sito, seguito da un blockquote con una descrizione sintetica che riassume in una frase di cosa si occupa il dominio. Dopo il blockquote possono comparire paragrafi liberi con note aggiuntive, poi una serie di sezioni introdotte da H2, ciascuna dedicata a un tema (per esempio documentazione, guide, prodotti) con un elenco puntato di link e una breve descrizione per ogni voce.
Una sezione facoltativa chiamata Optional raccoglie i contenuti considerati meno prioritari, che un sistema può ignorare senza perdere le informazioni principali del sito. Questa distinzione tra contenuti prioritari e contenuti secondari è la parte più utile della struttura, perché costringe chi scrive il file a scegliere con criterio cosa merita attenzione, invece di elencare ogni pagina esistente.
Quali link e pagine inserire
Le pagine da inserire sono quelle che rappresentano il nucleo informativo del sito: pagine di prodotto o di servizio con valore commerciale diretto, documentazione tecnica per chi sviluppa integrazioni, guide che rispondono alle domande più frequenti degli utenti. Le pagine duplicate, gli archivi con contenuto scarso o le landing page create solo per campagne pubblicitarie a termine vanno escluse, perché appesantiscono il file senza aggiungere valore.
Un errore comune consiste nell’inserire decine di URL generati automaticamente dal CMS senza controllo editoriale. Un file con dieci o venti link curati con attenzione risulta più utile di un elenco di duecento pagine prive di gerarchia, perché la selezione stessa è l’informazione che un sistema AI riceve sulla priorità dei contenuti.
Nelle verifiche svolte sui contenuti, gli elenchi automatici tendono a includere archivi, pagine sovrapposte o risorse ormai marginali. La revisione diventa quindi una scelta editoriale, non un controllo formale sul numero di URL presenti.
llms-full.txt e versioni Markdown dei contenuti
Accanto a llms.txt esiste una variante facoltativa chiamata llms-full.txt, che contiene il testo completo delle pagine indicate, concatenato in un unico documento Markdown pensato per essere caricato per intero nel contesto di un modello. Mentre llms.txt funziona come indice con link, llms-full.txt funziona come corpus già pronto per la lettura, senza bisogno di ulteriori richieste HTTP verso le pagine originali.
Alcuni siti di documentazione tecnica pubblicano anche versioni Markdown delle singole pagine, raggiungibili aggiungendo l’estensione .md alla stessa URL della pagina HTML. Questa pratica, adottata per esempio da progetti open source e da piattaforme di documentazione per sviluppatori, riduce il lavoro di conversione richiesto a un agente di coding che deve leggere rapidamente un riferimento tecnico.
Come creare un file llms.txt manualmente
Creare un file llms.txt manualmente richiede quattro passaggi: selezionare i contenuti da includere, scrivere il file seguendo la sintassi proposta, pubblicarlo nella directory principale del sito e verificare che sia raggiungibile con una risposta HTTP corretta. Il procedimento non richiede strumenti particolari, basta un editor di testo e accesso alla root del dominio.
Selezionare i contenuti principali del sito
La selezione dei contenuti principali richiede di rispondere a una domanda semplice: quali pagine risponderebbero meglio a chi chiede informazioni sul sito senza conoscerlo già? Per un’azienda di servizi possono essere le pagine di servizio più richieste e la pagina chi siamo, per un ecommerce le categorie con maggiore fatturato, per un progetto software la documentazione di avvio rapido e il riferimento API.
Un criterio pratico consiste nel confrontare questa selezione con le pagine che già ricevono più traffico organico o più richieste di preventivo, dato disponibile in un qualsiasi strumento di analisi del traffico. Le pagine con performance già solida meritano di comparire per prime, perché rappresentano il contenuto che l’azienda considera già strategico per i propri utenti.
Nel lavoro svolto con aziende e professionisti, il traffico non è l’unico criterio che usiamo per stabilire le priorità. Una pagina con poche visite può meritare spazio quando risponde a richieste commerciali ricorrenti, chiarisce un servizio complesso o riduce domande ripetute al team.
Scrivere il file seguendo la sintassi proposta
Il file va scritto come Markdown puro, con un H1 iniziale per il nome del sito, un blockquote con la descrizione sintetica e sezioni H2 con elenchi di link nel formato standard: testo del link tra parentesi quadre, URL tra parentesi tonde, seguito da un trattino e una breve descrizione. Ogni riga deve restare autonoma e comprensibile anche isolata dal resto del file.
Un esempio minimo di struttura corretta può essere: un H1 con il nome dell’azienda, un blockquote con una frase sul settore di attività, una sezione H2 chiamata Servizi con due o tre link alle pagine principali, e una sezione H2 Documentazione se il sito ne dispone. Non serve includere ogni pagina del sito, ma solo quelle scelte nella fase precedente.
Pubblicare llms.txt nella directory principale
Il file deve trovarsi nella directory root del dominio, raggiungibile all’indirizzo esempio.com/llms.txt, esattamente come avviene per robots.txt. Un file caricato in una sottocartella non viene considerato valido dalla maggior parte degli strumenti che lo cercano, perché la convenzione prevede la posizione fissa nella radice del sito.
La pubblicazione avviene tramite lo stesso accesso FTP o pannello di gestione file usato per caricare robots.txt o altri file statici. Su hosting condivisi con restrizioni di scrittura nella root, alcune piattaforme permettono di servire il file in modo virtuale tramite configurazione del server, senza doverlo caricare fisicamente come file separato.
Verificare URL, risposta HTTP e contenuto
Dopo la pubblicazione va verificato che l’indirizzo restituisca una risposta HTTP 200 e non un errore 404, aprendo l’URL in una finestra di navigazione privata per escludere contenuti in cache. Va controllato anche che il file venga servito come testo semplice o Markdown e non come pagina HTML, perché un content type errato può impedire la lettura corretta da parte di un parser.
Un controllo da aggiungere a questa verifica consiste nel consultare i log del server nelle settimane successive alla pubblicazione, per verificare se qualche user agent automatico ha richiesto il file.
Dalle analisi che conduciamo, la sola presenza del file nei log non dimostra che le pagine elencate siano state comprese o citate. Consideriamo la richiesta un segnale tecnico da contestualizzare, non una prova di efficacia.
Esempio completo di file llms.txt
Un esempio realistico per un’azienda che offre servizi digitali può aiutare a capire la proporzione corretta tra sezioni e contenuti. Il file seguente mostra una struttura completa ma contenuta, adatta a un sito aziendale di medie dimensioni.
# Nome Azienda > Nome Azienda offre consulenza SEO e sviluppo di siti web per piccole e medie imprese in Italia. ## Servizi - [Consulenza SEO](https://esempio.com/consulenza-seo): Analisi tecnica, contenuti e link building per il posizionamento organico - [Sviluppo siti web](https://esempio.com/sviluppo-siti-web): Progettazione e realizzazione di siti su WordPress ed Elementor ## Risorse - [Blog](https://esempio.com/blog): Approfondimenti su SEO, contenuti e marketing digitale - [Casi studio](https://esempio.com/casi-studio): Risultati misurabili ottenuti per clienti reali ## Optional - [Chi siamo](https://esempio.com/chi-siamo): Storia e team dell'agenzia - [Note legali](https://esempio.com/note-legali): Informazioni societarie e privacy
La proporzione da mantenere è due o tre sezioni tematiche con pochi link ciascuna, più una sezione Optional per i contenuti di contorno. Un file più lungo di questo esempio non produce automaticamente un risultato migliore, perché l’obiettivo resta la sintesi, non l’elenco completo del sito.
Come creare llms.txt su WordPress
Su WordPress il file llms.txt può essere creato con un plugin SEO oppure manualmente nella root del sito. I plugin evitano l’accesso FTP e aggiornano il file in base ai contenuti pubblicati, mentre la gestione manuale consente di scegliere con maggiore precisione quali pagine inserire.
Creare e gestire il file con Yoast SEO
Yoast SEO include la generazione automatica di llms.txt a partire dai contenuti pubblicati e consente di passare alla gestione manuale per selezionare le risorse da mostrare nel file. Il plugin espone l’opzione nelle impostazioni dedicate, senza richiedere interventi sul server.
Chi gestisce un sito con Yoast può scegliere quali tipologie di contenuto includere, escludendo per esempio gli articoli più datati o le pagine marcate come noindex, che vengono automaticamente tenute fuori dal file generato.
Attivare e configurare llms.txt con Rank Math
Rank Math genera il file elencando titolo, URL e descrizione dei contenuti selezionati; la configurazione llms.txt di Rank Math permette inoltre di includere tassonomie come categorie e tag e di impostare il numero massimo di voci. Il numero di voci da includere è configurabile, così da adattare il file a siti piccoli o a archivi molto estesi.
Anche in questo caso i contenuti impostati su noindex vengono esclusi automaticamente, e il plugin permette di aggiungere manualmente link o note che non provengono da un post o da una pagina esistente, utile per segnalare risorse esterne rilevanti per il settore.
Generare il file con All in One SEO
All in One SEO include una procedura per creare llms.txt con AIOSEO e configurare i contenuti da inserire nel file. La logica di esclusione dei contenuti noindex segue lo stesso principio degli altri plugin SEO citati.
Per i siti che gestiscono più tipologie di contenuto, come un blog aziendale affiancato a un catalogo prodotti, la configurazione permette di scegliere quali custom post type includere nel file, evitando che categorie non pertinenti finiscano nell’elenco.
Usare un plugin dedicato
Esistono plugin dedicati esclusivamente alla generazione di llms.txt, pensati per chi non utilizza uno dei tre plugin SEO principali o per chi vuole controlli più granulari, come pattern di inclusione ed esclusione basati su wildcard di URL o la generazione automatica anche di llms-full.txt accanto al file indice. Questi plugin rispettano comunque le impostazioni noindex già presenti nel sito, integrandosi con Yoast, Rank Math o altri plugin SEO installati.
La scelta tra plugin SEO integrato e plugin dedicato dipende dal livello di controllo richiesto: un sito semplice trae beneficio dalla generazione automatica già inclusa nel plugin SEO esistente, mentre un sito con esigenze editoriali complesse può preferire uno strumento con più opzioni di filtro.
Durante la gestione dei progetti preferiamo evitare un secondo plugin quando quello SEO già installato consente una selezione adeguata. Un’estensione dedicata acquista senso solo quando servono filtri, versioni Markdown o regole che la soluzione esistente non permette di gestire.
Limiti dei file generati automaticamente
Un file llms.txt generato in automatico da un plugin rischia di riprodurre la struttura del sito invece di offrire una selezione editoriale, perché il criterio predefinito spesso include gli ultimi contenuti pubblicati per data, non quelli più rilevanti per un utente che non conosce già il sito. Questo comportamento riduce il valore stesso dello strumento.
Nessun plugin, per quanto configurabile, sostituisce una revisione umana che decida quali pagine meritano di comparire per prime. Un’azienda che genera il file e non lo controlla più rischia di ritrovarsi con link a contenuti superati, prodotti non più in vendita o pagine che nel frattempo sono state rimosse, con una conseguenza diretta sulla credibilità del file agli occhi di chi (umano o sistema) lo consulta.
Anche la generazione automatica di llms-full.txt comporta un rischio aggiuntivo: pubblicare per intero i contenuti di pagine riservate a clienti o di documentazione interna può esporre informazioni che l’azienda non intendeva rendere liberamente accessibili in un unico file scaricabile, questione che vale la pena verificare prima di attivare la funzione senza controllo.
Nei progetti con aree riservate o documentazione distribuita tra più reparti, verifichiamo prima quali contenuti sono pubblici per scelta e quali risultano raggiungibili solo per configurazioni pregresse. La generazione automatica può rendere molto più evidente materiale che fino a quel momento era rimasto poco accessibile.
Differenze tra llms.txt, robots.txt e sitemap.xml
Robots.txt, sitemap.xml e llms.txt rispondono a tre domande diverse e non sono intercambiabili. Il file robots.txt contiene regole di accesso per i crawler, usate principalmente per gestire quali URL possono essere richieste e il carico prodotto sul server. Non è uno strumento per nascondere pagine dai risultati di ricerca, funzione che richiede invece il meta tag noindex.
La sitemap.xml elenca le URL che il proprietario del sito vuole segnalare ai motori di ricerca e può favorire la scoperta delle pagine del sito, comprese quelle difficili da raggiungere tramite i link interni. È un elenco tecnico e completo, pensato per la scoperta, non per la selezione editoriale.
Llms.txt fa qualcosa di diverso da entrambi: presenta una selezione descrittiva e curata delle risorse ritenute più importanti, scritta per essere letta da un modello linguistico, non un elenco completo né una direttiva di accesso. La tabella seguente riassume le tre funzioni per chi deve decidere quale file mantenere aggiornato con priorità.
Nel nostro lavoro quotidiano incontriamo ancora configurazioni in cui sitemap, robots.txt e llms.txt vengono trattati come file equivalenti. Tenerli distinti evita interventi impropri, come usare robots.txt per nascondere contenuti o aspettarsi che llms.txt favorisca l’indicizzazione.
| File | Funzione principale | Destinatario tipico | Obbligatorio per il SEO |
|---|---|---|---|
| robots.txt | Gestisce l’accesso dei crawler alle URL | Motori di ricerca e crawler generici | Consigliato su ogni sito |
| sitemap.xml | Elenca tutte le URL indicizzabili | Motori di ricerca | Consigliato su siti medi e grandi |
| llms.txt | Presenta una selezione curata di contenuti prioritari | Agenti AI e strumenti di sviluppo | Non richiesto da Google Search |
| llms-full.txt | Fornisce il testo completo delle pagine indicate | Agenti di coding e pipeline di ingestione | Facoltativo |
Llms.txt funziona? Cosa mostrano i test
I dati raccolti nel 2026 mostrano un divario netto tra adozione del file e utilizzo effettivo da parte dei sistemi AI. Le tre categorie da distinguere sono le richieste rilevate nei log dei server, la capacità del file di aiutare la scoperta delle pagine e l’effetto misurabile su citazioni e traffico proveniente da sistemi AI.
L’adozione del file è cresciuta, ma questo dato non dimostra che venga consultato. Nello studio Ahrefs su 137.210 domini, il 28% pubblicava un file llms.txt valido; la stessa analisi ha però rilevato che il 97% di quei file non aveva ricevuto alcuna richiesta nel mese osservato.
Richieste al file rilevate nei log dei server
Lo studio Ahrefs su 137.000 siti, pubblicato il 15 giugno 2026, ha rilevato circa 38.000 domini con un file valido; il 97% di quei file non ha ricevuto richieste nel mese osservato. Tra il ristretto 3% di file che ha ricevuto traffico, la maggioranza delle richieste proveniva da bot non collegati a sistemi AI di risposta diretta, come strumenti di audit SEO o crawler generici.
Tra i file che hanno ricevuto richieste, il 77% degli accessi proveniva da bot estranei agli strumenti AI, come crawler SEO, sistemi di profilazione tecnica e crawler generici. Gli agenti AI e le infrastrutture agentiche rappresentavano il 10,5% delle richieste, mentre gli assistenti AI che navigano il web per rispondere a una domanda pesavano soltanto per il 2,5%. Una richiesta al file dimostra comunque solo che l’URL è stato recuperato, non che il contenuto sia stato usato per generare una risposta.
Test sulla scoperta delle pagine
Un’analisi su 300.000 domini condotta da SE Ranking non ha rilevato una correlazione tra la presenza di llms.txt e la frequenza con cui un dominio viene citato dai sistemi di risposta AI. In altre parole, avere il file non ha coinciso, nel campione osservato, con una maggiore probabilità di comparire come fonte in una risposta generata.
Nel campione analizzato da SE Ranking, la presenza di llms.txt non ha aumentato la frequenza delle citazioni nei sistemi AI. Il file compariva nel 10,13% dei quasi 300.000 domini esaminati, ma la variabile non migliorava la capacità del modello statistico di prevedere quali siti sarebbero stati citati.
Effetti su citazioni, traffico e visibilità AI
L’utilità ipotizzata per llms.txt riguardava soprattutto la possibilità di ottenere più citazioni nelle risposte di ChatGPT, Perplexity o altri assistenti AI. Il supporto dichiarato da questi sistemi resta però assente o non confermato: nessuna delle principali piattaforme ha annunciato ufficialmente di usare llms.txt come segnale per selezionare le fonti da citare.
I test disponibili non mostrano aumenti misurabili delle citazioni o del traffico AI attribuibili alla presenza di llms.txt. Google Search dichiara inoltre che il file non migliora e non peggiora visibilità o ranking. L’impiego più definito resta la distribuzione di documentazione in formato Markdown quando un agente o uno strumento viene indirizzato esplicitamente verso quella risorsa.
Per quanto osserviamo sui progetti, il file viene spesso proposto prima che siano stati risolti problemi più evidenti, come pagine poco chiare, contenuti duplicati o documentazione difficile da raggiungere. In questi casi spostiamo la priorità sugli interventi che migliorano subito l’accesso alle informazioni per utenti e crawler.
Quando conviene creare llms.txt
Llms.txt ha più senso nei siti che pubblicano documentazione tecnica, API o riferimenti destinati agli sviluppatori, perché il formato può fornire una sintesi organizzata dei contenuti a browser agent e strumenti di sviluppo. Non esistono però prove che Cursor, Claude Code o altri sistemi cerchino e utilizzino automaticamente il file su ogni dominio.
Per un’azienda con un sito di servizi locali, un ecommerce generalista o un blog rivolto a un pubblico non tecnico, il tempo dedicato a llms.txt ha un ritorno atteso più basso rispetto ad altre attività, come il miglioramento della struttura dei contenuti, la chiarezza delle pagine di servizio o la solidità dei dati strutturati già richiesti dalla SEO tradizionale.
Un criterio decisionale rapido può basarsi su tre domande da verificare prima di procedere.
- Il sito dispone già di una documentazione tecnica pubblica organizzata per sezioni?
- Il pubblico include sviluppatori, agenzie o team tecnici che integrano servizi tramite strumenti AI?
- Il tempo richiesto per curare manualmente un file di poche righe è proporzionato al beneficio atteso in questo contesto specifico?
Se la risposta a queste domande resta negativa, altre priorità SEO restano più redditizie nel breve periodo.
Nei confronti con i responsabili marketing, questa verifica aiuta anche a evitare attività difficili da giustificare internamente. Un file di poche righe può richiedere poco tempo, ma diventa una distrazione quando sottrae attenzione a pagine commerciali incomplete, tracciamenti assenti o problemi tecnici già noti.
Come controllare e aggiornare il file nel tempo
Un file llms.txt pubblicato e mai più aggiornato perde valore più in fretta di quanto sembri, perché link a pagine rimosse o prodotti non più disponibili trasmettono un’informazione scorretta a chiunque lo consulti. Il controllo periodico va programmato con la stessa logica riservata alla manutenzione di una sitemap.
- Verificare ogni URL elencata nel file per escludere risposte 404 o redirect non aggiornati
- Confrontare la selezione dei contenuti con le pagine che hanno guadagnato o perso rilevanza negli ultimi mesi
- Controllare nei log del server se sono comparse nuove richieste da user agent riconducibili a sistemi AI o di sviluppo
Una cadenza trimestrale è generalmente sufficiente per un sito con aggiornamenti regolari, mentre un progetto software con rilasci frequenti può richiedere una revisione più ravvicinata, in particolare quando cambiano le API o la struttura della documentazione. Il problema di fondo di llms.txt oggi non è tecnico ma di priorità: prima di investire tempo nella sua manutenzione, conviene stabilire se il pubblico del sito rientra tra quello che, secondo i dati disponibili, consulta questo tipo di file con una certa regolarità, e destinare il resto delle risorse a un controllo tecnico complessivo della struttura del sito, dei contenuti e della loro effettiva leggibilità per motori di ricerca e sistemi AI.
Quando il file viene adottato, inseriamo la sua revisione nello stesso controllo che riguarda sitemap, redirect e pagine rimosse. Separarlo dalla manutenzione ordinaria aumenta il rischio che resti online con URL superate senza che nessuno se ne accorga.
