Mikä on llms.txt ja kannattaako tiedosto julkaista sivustolle?

llms.txt, jota haetaan usein myös muodoissa llm.txt, llm txt tai llms txt, on verkkosivuston polussa /llms.txt tarjoiltava Markdown-tiedosto. Se antaa tekoälytyökaluille lyhyen, kuratoidun kartan siitä, mikä sivusto on ja mitkä sen sivuista ovat tärkeimpiä. Jeremy Howard esitteli ehdotuksen syyskuussa 2024 yhteisöaloitteena virallisen standardin sijaan. Marraskuussa 2026 Google ilmoittaa hakunsa ohittavan tiedoston, ja Ahrefsin lokitutkimuksessa 97 prosenttia mitatuista llms.txt-tiedostoista ei saanut yhtään pyyntöä toukokuussa 2026. Tiedoston luominen on halpaa, mutta sen tuoma sijoitus- tai viittaushyöty on toistaiseksi osoittamatta.

Mikä on llms.txt-tiedosto?

llms.txt on puhdas Markdown-muotoinen tekstitiedosto, joka sijoitetaan sivuston juureen esimerkiksi osoitteeseen https://www.example.com/llms.txt. Sen tehtävä on antaa kielimallille tai tekoälyagentille valmis sivustokartta, jotta agentin ei tarvitse päätellä rakennetta valikoista, JavaScriptistä ja sivuaineiston hälystä. Hakijat käyttävät muotoja llm txt, llm.txt, llms txt ja llms.txt lähes tasatahtiin, ja kaikki neljä tarkoittavat samaa tiedostoa.

Jeremy Howard julkaisi ehdotuksen osoitteessa llmstxt.org 3. syyskuuta 2024. Projekti toimii GitHubissa AnswerDotAI-organisaation alla, ja ehdotussivu kantaa nyt versionumeroa 2. Ehdotuksen mukaan agentti lukee tiedoston tarpeen mukaan auttaessaan käyttäjää ja seuraa linkkejä tarkempiin lähteisiin. Tiedosto voi sijaita verkkotunnuksen juuressa tai alipolussa kuten /docs/llms.txt, jolloin se kattaa kyseisen polun alaiset sivut.

llms.txt on yhteisöehdotus, ei standardointijärjestön vahvistama standardi. Rank Mathin ohjeistus kuvaa sitä ehdotukseksi virallisen standardin sijaan, ja Chromen Lighthouse-dokumentaatio luokittelee sen kehittyväksi käytännöksi.

Mitä llms.txt-tiedostoon kirjoitetaan?

llms.txt-tiedostoon kirjoitetaan alkuperäisen ehdotuksen mukaan neljä Markdown-osaa tarkassa järjestyksessä:

1. H1-tason otsikko, joka kertoo sivuston tai projektin nimen. Tämä on tiedoston ainoa pakollinen osa.
2. Lainauslohko eli blockquote, joka tiivistää lyhyesti olennaiset perustiedot lopputiedoston ymmärtämiseksi.
3. Valinnaiset tekstikappaleet tai listat ilman väliotsikoita tarkentaville faktoille.
4. Valinnaiset H2-osiot, jotka sisältävät linkkilistoja. Jokainen rivi on Markdown-lista-alkio, jossa on pakollinen linkki muodossa [nimi](url) ja haluttaessa kaksoispisteen perässä lyhyt faktahuomio sivusta.

Vakiintuneen käytännön mukaan H2-osio nimeltä Optional kokoaa toissijaiset linkit, jotka agentti voi ohittaa silloin, kun konteksti-ikkuna halutaan pitää tiiviinä. Alla on valmis esimerkkirakenne kuvitteelliselle yritykselle varatulla example.com-verkkotunnuksella.

# Northwind Analytics

> Northwind Analytics on evästeetön verkkoanalytiikkatyökalu pienille verkkokaupoille. Palvelu seuraa tilauksia, liikennelähteitä ja palaavia asiakkaita.

Northwindia myy Northwind Software Ltd Dublinissa. Hinnat ilmoitetaan euroissa ilman arvonlisäveroa.

## Product

- [Features](https://www.example.com/features): mitä hallintapaneeli näyttää ja mitkä kauppa-alustat yhdistyvät
- [Pricing](https://www.example.com/pricing): paketit, rajat ja maksuton kokeilu

## Docs

- [Quickstart](https://www.example.com/docs/quickstart): asenna seurantakoodi ja tarkista datan saapuminen
- [API reference](https://www.example.com/docs/api): päätepisteet, tunnistautuminen ja pyyntörajat

## Policies

- [Privacy policy](https://www.example.com/privacy): mitä tietoja kerätään ja kuinka kauan niitä säilytetään
- [Terms of service](https://www.example.com/terms)

## Optional

- [Changelog](https://www.example.com/changelog): julkaisutiedotteet
- [Blog](https://www.example.com/blog): artikkelit ja asiakastarinat

Viisi käytäntöä pitää tiedoston täsmällisenä ja koneellisesti luettavana:

• Linkitä vain julkisille sivuille, jotka palauttavat HTTP-tilakoodin 200, ja käytä täydellisiä URL-osoitteita.
• Kirjoita jokaisen linkin kuvaus faktana siitä, mihin kysymykseen sivu vastaa, älä mainoslauseena.
• Pidä alkutiivistelmä lyhyenä ja nimeä tuote, kohderyhmä sekä ydintoiminto.
• Siirrä harvemmin tarvittavat linkit Optional-otsikon alle.
• Tallenna tiedosto UTF-8-tekstinä. Ehdotus ei määrää sisältötyyppiä, ja bot.spot tarjoilee oman tiedostonsa muodossa text/plain; charset=utf-8.

Ehdotuksen versio 2 esittelee myös kaksi valinnaista kytkentää sivujen ja tiedoston välille. Sivu voi viitata Markdown-kopioonsa määreellä rel="alternate" type="text/markdown" ja sitä kuvaavaan llms.txt-tiedostoon määreellä rel="describedby" joko HTML-otsakkeessa tai HTTP Link -otsakkeessa:

<link rel="describedby" href="/llms.txt">
<link rel="alternate" type="text/markdown" href="/docs/quickstart.md">

Pidä molempia täysin valinnaisina lisinä, sillä yksikään tätä opasta varten tarkistettu lähde ei osoita tekoälytuotteiden hyödyntävän niitä.

Lukevatko tekoälyjärjestelmät llms.txt-tiedostoa oikeasti?

Yksittäiset työkalut ja koodausagentit noutavat llms.txt-tiedoston, mutta Googlen mukaan Google Search ohittaa sen, eivätkä OpenAI, Anthropic tai Perplexity dokumentoi hakubottiensa lukevan sitä marraskuussa 2026.

Mitä Google on sanonut julkisesti?

Googlen opas sivuston optimoinnista Google-haun generatiivisille tekoälyominaisuuksille toteaa suoraan, ettet tarvitse llms.txt-tiedostoja, muita tekoälytekstitiedostoja, lisämerkintöjä tai Markdown-kopioita näkyäksesi Googlen haussa. Google Search ohittaa tiedoston, joten se ei paranna eikä heikennä näkyvyyttä, vaikka tiedoston voi halutessaan julkaista muita palveluita varten.

Googlen hakutiimi on toistanut saman linjan julkisuudessa useasti:

• Huhtikuu 2025. John Mueller vertasi llms.txt-tiedostoa vanhaan keywords-metatunnisteeseen, eli sivuston omaan vahvistamattomaan väitteeseen sisällöstään, kertoo Search Engine Journal.
• Kesäkuu 2025. Mueller kirjoitti Blueskyssa, ettei mikään tekoälyjärjestelmä käytä tällä hetkellä llms.txt-tiedostoa, ja Search Engine Roundtable raportoi hänen viitanneen palvelinlokeihin, joissa keskustelubotit hakevat sivuja mutta ohittavat llms.txt-polun.
• Heinäkuu 2025. Search Engine Journalin raportti Bangkokin Search Central Live -tapahtumasta kertoi, ettei Gary Illyes pitänyt ehdotusta hyödyllisenä Googlelle eikä suunnitellut sen käyttöönottoa.
• Kesäkuu 2026. Search Off the Record -podcastissa Mueller totesi, etteivät kielimallit voi erottaa sivustoja toisistaan sivuston itse kirjoittaman tiedoston perusteella. Search Engine Journalin mukaan hän piti mahdollisena yhtä kapeaa käyttötapaa: agentin opastamista sivuston sisällä esimerkiksi osto-ohjeiden pariin.

Googlen Chrome-tiimi tarkastelee tiedostoa eri kulmasta. Lighthousessa on llms.txt-tarkistus Agentic Browsing -kategoriassa. Tarkistus nostaa virheen palvelinvirheestä ja kuittaa puuttuvan 404-vastauksen ei-soveltuvaksi, eli se mittaa selainagenttien valmiutta hakusijoitusten sijaan.

Mitä palvelinlokit näyttävät?

Ahrefs julkaisi lokipohjaisen tutkimuksen 15. kesäkuuta 2026 tarkastettuaan 137 210 Ahrefs Web Analyticsia käyttävää verkkotunnusta, jotka saivat liikennettä toukokuussa 2026:

• 28 prosenttia verkkotunnuksista julkaisi kelvollisen llms.txt-tiedoston, mitä Ahrefs pitää ylärajana asiakaskuntansa teknisen painotuksen vuoksi.
• 97 prosenttia näistä tiedostoista ei saanut yhtään pyyntöä toukokuun aikana. Kaikki mitattu llms.txt-liikenne, noin 22 000 pyyntöä, keskittyi noin 1 100 verkkotunnukselle.
• Botit tekivät 96 prosenttia liikennettä saaneiden tiedostojen pyynnöistä.
• Ahrefs ei mitannut llms-full.txt-tiedostoja eikä tarkistanut, noudattivatko tiedostot spesifikaatiota.

Alla oleva taulukko näyttää, miltä toimijoilta pyynnöt tulivat osuutena kaikista llms.txt-pyynnöistä.

Nimetyistä boteista suurin koulutushakubotti oli GPTBot 4,51 prosentin osuudella ja ClaudeBot keräsi 0,8 prosenttia. Search Engine Journalin yhteenvedon mukaan koodausagentti Claude Code kuului aktiivisimpiin yksittäisiin hakijoihin, kun taas ChatGPT:n ja Perplexityn vastauksia hakevat botit tekivät vain noin 1 prosentin pyynnöistä. Lokirivi todistaa vasta tiedoston noudon, ei sitä, että sisältö olisi muuttanut vastausta.

Mitä tutkimukset kertovat vaikutuksesta viittauksiin?

SE Ranking analysoi lähes 300 000 verkkotunnusta, löysi llms.txt-tiedoston 10,13 prosentilta niistä eikä havainnut minkäänlaista yhteyttä tiedoston ja tekoälyvastausten lähdeviittausten välillä. Muuttujan poistaminen tilastomallista paransi mallin tarkkuutta, mistä tutkijat päättelivät tiedoston tuovan aineistoon enemmän kohinaa kuin signaalia.

Käyttöönottoaste riippuu otoksesta. Originality.ai seurasi yli 3 miljoonaa sivustoa kesäkuusta 2025 toukokuuhun 2026 ja laski llms.txt-sivustojen määrän nousseen 4 088 sivustosta 36 120 sivustoon sekä llms-full.txt-sivustojen 23 sivustosta 2 463 sivustoon. Myös ominaisuutta myyvä SEOPress huomauttaa version 9.5 julkaisutiedoissa, ettei valtaosa kielimalleista nojaa tiedostoon vakioidusti eikä se ole sijoitus- tai liikennevipu.

Kannattaako tiedosto silti luoda?

Tiedoston luominen maksaa vähän aikaa, ja näyttö tukee maltillista käyttöä dokumentaatio- ja kehittäjäsivustoilla, joilta koodausagentit hakevat ohjeita. Esimerkiksi Next.js julkaisee indeksin polussa /docs/llms.txt ja linkittää siihen sivuiltaan, ja Mintlify luo tiedoston oletuksena jokaiselle dokumentaatioprojektille.

Sijoitus- tai viittaustaktiikkana llms.txt on heikko panostus. Pidä sitä pienenä osana laajempaa koneellista luettavuutta, jota AEO-, GEO- ja SEO-oppaamme kuvaa. Jos julkaiset tiedoston, mittaa vaikutus olettamisen sijaan: bot.radar ajaa ostajien kysymykset päivittäin kaikissa seitsemässä tekoälymoottorissa ja tallentaa mainitut brändit sekä siteeratut URL-osoitteet. Brand-paketti hintaan 79 €/kk sisältää 150 yksikköä ja Agency hintaan 199 €/kk 450 jaettua yksikköä 30 päivän kortittomalla kokeilulla.

Miltä oikea tuotannossa oleva llms.txt näyttää?

Tuotannossa oleva llms.txt kokoaa yhteen yrityksen perustiedot ja keskeiset sivut. bot.spot julkaisee oman tiedostonsa osoitteessa /llms.txt, ja alla on lyhennetty ote, jossa kolme pistettä merkitsevät pois jätettyjä rivejä.

# bot.spot

> bot.spot is an AI visibility and optimization platform for brands and marketing agencies. Get found, cited and chosen in AI search.

...

## About this entity

bot.spot (also written Botspot) is a software company operated by Botdot Oy in Finland. It builds AI visibility and optimization software for brands and marketing agencies. It is not affiliated with Boston Dynamics or its Spot robot, with the botspot.app photogrammetry scanner, or with botspot.trade.

...

## Pages

- [Home](https://www.bot.spot/): platform overview, products, and FAQ
- [Pricing](https://www.bot.spot/pricing): plans, trial allowances and usage rates

...

## Machine-readable

- Sitemap: https://www.bot.spot/sitemap.xml
- robots.txt: https://www.bot.spot/robots.txt

Koko tiedosto jakautuu kuuteen osaan:

bot.spotin tiedosto muodostetaan automaattisesti Next.js-reitillä samasta tietolähteestä, joka syöttää sivun AI Appendix -osion ja JSON-LD-merkinnät, joten yksi tekstipäivitys päivittää kaikki kolme pintaa tunnin välimuistilla. Rehellisyyden nimissä oma tiedostomme poikkeaa silti ehdotuksen tiukimmasta mallista neljässä kohdassa: se on pitkä, siitä puuttuu Optional-osio, koneelliset linkit ovat paljaita URL-osoitteita [nimi](url)-muodon sijaan, ja toivotuslause tekoälyboteille on pelkkä tahdonilmaisu, sillä vain robots.txt ohjaa hakubotteja teknisesti.

Miten luot llms.txt-tiedoston omalle sivustollesi?

llms.txt-tiedoston luominen noudattaa samoja kuutta vaihetta julkaisualustasta riippumatta:

1. Päätä tiedoston käyttötarkoitus miettimällä, mitkä sivut antaisit uudelle kollegalle tai yrityksestäsi vastaavalle agentille.
2. Valitse mukaan tuote- ja palvelusivut, hinnasto, dokumentaatio, ehdot ja selkeimmät oppaat. Jätä pois ohuet arkistosivut, kirjautumissivut, suodatinparametrit ja noindex-sivut.
3. Kirjoita H1-otsikko ja kahden virkkeen tiivistelmä siitä, mikä sivusto on ja kenelle se on tehty.
4. Ryhmittele linkit H2-otsikoiden alle ja lisää jokaiselle lyhyt faktakuvaus.
5. Siirrä toissijaiset linkit ## Optional -otsikon alle.
6. Julkaise tiedosto polussa /llms.txt, hae osoite ja tarkista palautuva teksti.

Valmiit generaattorit esimerkiksi Mintlifyssa, GitBookissa, Yoast SEO:ssa, AIOSEO:ssa ja Wixissä osaavat luonnostella tiedoston puolestasi. Pelkästä XML-sivukartasta kopioitu luonnos toistaa kuitenkin vain sivukartan Markdown-muodossa, joten karsi lista aina käsin tärkeimpiin sivuihin.

Staattinen sivusto

Staattisella sivustolla tallenna llms.txt UTF-8-muodossa kansioon, jonka sivustogeneraattori kopioi suoraan julkaisun juureen, kuten Next.js:n public-kansioon. Aja julkaisun ja CDN-välimuistin tyhjennyksen jälkeen tarkistuskomento:

curl -i https://www.example.com/llms.txt

Vastauksen tulee näyttää tilakoodi 200, tekstisisältötyyppi ja puhdas Markdown-runko ilman HTML-koodia tai uudelleenohjausta etusivulle.

WordPress

Marraskuussa 2026 useat suuret WordPress-lisäosat osaavat muodostaa tiedoston suoraan, joten tarkista nykyisen SEO-lisäosasi asetukset ennen uuden asentamista.

Taulukon tiedot perustuvat Yoastin, Rank Mathin, All in One SEO:n, SEOPress 9.5 -julkaisun ja Website LLMs.txt -sivun dokumentaatioon. Kytke päälle vain yksi generaattori, karsi pois arkisto- ja avainsanasivut ja tyhjennä välimuisti. Sivukohtaiseen rakenteiseen sisältöön voit tutustua oppaassamme WordPressin hakukoneoptimoinnista ja GEO:sta, jossa käydään läpi myös itsepalveluna toimiva bot.optimizer-lisäosa.

Next.js App Router

Next.js App Routerissa helpoin tapa on tallentaa staattinen tiedosto public-kansioon. Jos haluat koostaa tiedoston dynaamisesti esimerkiksi julkaisujärjestelmän sivuista, luo reittikäsittelijä polkuun app/llms.txt/route.ts:

// app/llms.txt/route.ts
const SITE_URL = "https://www.example.com";

const sections = [
  {
    title: "Docs",
    links: [
      { name: "Quickstart", path: "/docs/quickstart", note: "Install and send a first request" },
      { name: "API reference", path: "/docs/api", note: "Endpoints, authentication and limits" },
    ],
  },
];

// Regenerate at most once an hour.
export const revalidate = 3600;

export async function GET() {
  const body = [
    "# Example",
    "",
    "> One or two plain sentences on what Example is and who it is for.",
    "",
    ...sections.flatMap((section) => [
      `## ${section.title}`,
      "",
      ...section.links.map(
        (link) => `- [${link.name}](${SITE_URL}${link.path}): ${link.note}`,
      ),
      "",
    ]),
  ].join("\n");

  return new Response(body, {
    headers: { "Content-Type": "text/plain; charset=utf-8" },
  });
}

Huomioi kolme teknistä yksityiskohtaa: Next.js 15 muutti GET-reittikäsittelijät oletuksena dynaamisiksi, joten aseta revalidate tai export const dynamic = "force-static" välimuistitusta varten. Kääri CMS-haku try/catch-lohkoon häiriöiden varalta ja varmista, etteivät kieliohjaukset tai tunnistautumissäännöt kaappaa /llms.txt-pyyntöä.

Miten llms.txt eroaa robots.txt- ja sitemap.xml-tiedostoista?

llms.txt, robots.txt ja sitemap.xml ratkaisevat kolme täysin eri tehtävää: llms.txt tarjoaa kuratoidun lukukartan kielimalleille, robots.txt kertoo hakuboteille sallitut polut ja sitemap.xml listaa indeksoitavat URL-osoitteet.

Taulukon lähteinä ovat RFC 9309, sivukarttaprotokolla ja Googlen sivukarttaopas. Koska llms.txt ei voi sallia tai estää yhtäkään bottia, hallitse tekoälyhakubotteja robots.txt-säännöillä: OpenAI erottelee OAI-SearchBot-, GPTBot- ja ChatGPT-User-tunnisteet, Anthropic listaa ClaudeBot-, Claude-SearchBot- ja Claude-User-botit, ja Perplexity dokumentoi PerplexityBot- ja Perplexity-User-asiakasohjelmat.

Mikä on llms-full.txt?

llms-full.txt on rinnakkaistiedosto, joka kokoaa sivuston koko tekstisisällön yhteen pitkään Markdown-dokumenttiin pelkkien linkkien sijaan. Itse llmstxt.org-ehdotus ei määrittele sitä, vaan käytäntö on peräisin dokumentaatioalustoista kuten Mintlifysta sekä All in One SEO:n lisäasetuksesta.

Täysi tekstivienti kasvaa helposti suuremmaksi kuin tekoälyavustajan kerralla lukema konteksti, joten pidä tiivis llms.txt ensisijaisena aloituspisteenä ja tuota llms-full.txt automaattisesti samasta lähdeaineistosta vain silloin, kun ylläpidät teknistä dokumentaatiota.

Miten tarkistat palvelinlokeista, lukevatko tekoälybotit llms.txt-tiedostoasi?

Tekoälybottien vierailut llms.txt-tiedostossa selviävät varmistamalla ensin tiedoston toimivuus curl-komennolla ja tutkimalla sen jälkeen palvelimen tai CDN-verkon raakalokit, sillä selaimessa ajettavat analytiikkaskriptit eivät näe JavaScriptiä suorittamattomia hakubotteja.

Nginxin tai Apachen tavallisesta yhdistetystä lokimuodosta saat pyyntömäärät asiakasohjelmittain komennolla:

grep ' /llms.txt ' access.log | awk -F'"' '{print $6}' | sort | uniq -c | sort -rn | head -20

Seuraava komento suodattaa esiin pelkät tunnetut tekoälybotit:

grep ' /llms.txt ' access.log | grep -E 'GPTBot|OAI-SearchBot|ChatGPT-User|ClaudeBot|Claude-SearchBot|Claude-User|PerplexityBot|Perplexity-User'

Tilakoodien jakauman näet komennolla:

awk '$7 == "/llms.txt" {print $9}' access.log | sort | uniq -c

Vertaa lokien user-agent-tunnisteita yhtiöiden viralliseen dokumentaatioon:

Koska kuka tahansa voi väärentää user-agent-merkkijonon, tarkista lähde-IP-osoitteet OpenAI:n, Anthropicin ja Perplexityn julkaisemista IP-listoista. Voit tarkistaa myös oman sivustosi hakubottipääsyn, robots.txt-säännöt, sivukartan ja llms.txt-tilan suoraan Claudessa tai ChatGPT:ssä bot.mcp-työkalun sivustoauditoinnilla.

Mitkä ovat yleisimmät llms.txt-virheet ja miten vältät ne?

Yleisimmät llms.txt-virheet liittyvät vääriin odotuksiin, rikkinäisiin polkuihin ja päällekkäisiin lisäosiin:

• Tiedoston luuleminen pääsynhallinnaksi. llms.txt ei estä tai salli yhtäkään hakubottia, vaan säännöt kuuluvat robots.txt-tiedostoon.
• Hakusijoitusten odottaminen. Google ohittaa tiedoston, eivätkä laajat toimialatutkimukset löytäneet yhteyttä tekoälyviittauksiin.
• Väärän sisällön palauttaminen. Uudelleenohjaus etusivulle, 200-koodin palauttava HTML-virhesivu tai kirjautumismuuri rikkoo tiedoston.
• Koko sivukartan kopiointi Markdowniin. Tiedoston arvo on karsinnassa, joten listaa vain tärkeimmät julkiset ja toimivat sivut.
• Mainoskielen kirjoittaminen. Pysy sivulta tarkistettavissa faktoissa ylisanojen sijaan.
• Kahden generaattorin ajaminen rinnakkain. Käsin ladattu tiedosto ja SEO-lisäosa tai kaksi lisäosaa sotkevat helposti saman URL-polun.
• Kohdebottien estäminen vahingossa. Jos robots.txt tai palomuuri estää tekoälyhakubotin, botti ei hae myöskään llms.txt-tiedostoasi.

Mitä llms.txt-tiedostosta kannattaa muistaa yhteenvedoksi?

llms.txt on nopea ja edullinen Markdown-opas osoitteessa /llms.txt, joka kokoaa sivustosi keskeiset linkit tekoälytyökaluille. Hyvä tiedosto sisältää H1-otsikon, lyhyen tiivistelmän, ryhmitellyt faktalinkit ja Optional-osion, ja sen voi julkaista staattisena tiedostona, WordPressin SEO-lisäosalla tai Next.js-reitillä. Marraskuussa 2026 Google ohittaa tiedoston ja 97 prosenttia tiedostoista jää ilman pyyntöjä kuukausitasolla, joten pidä odotukset maltillisina, pidä linkit kunnossa ja mittaa varsinainen tekoälynäkyvyys suoraan vastauksista.