CiteableAll guides

Guide

How to add an llms.txt to GitHub Pages (2026 guide)

Updated · July 10, 2026Joffrey

What is GEO?

GitHub Pages doesn't serve an llms.txt file by default. Here's how to add one — plus Q&A schema.org markup — so AI answer engines can read your GitHub Pages site and cite it in their answers. The steps are concrete and take a few minutes.

Why add an llms.txt on GitHub Pages?

AI answer engines (ChatGPT, Perplexity, Gemini, Claude) cite only a handful of sources per question, and they favor pages they can read cleanly. An llms.txt hands them a clear, structured version of your site; Q&A schema.org markup makes your answers quotable word for word. Without it, even ranking well on Google, your GitHub Pages site is unlikely to appear in an AI answer — not for lack of quality, but because nothing is machine-readable.

Add the llms.txt and Q&A markup on GitHub Pages

  1. Q&A markup: paste it into your site's <head> — via the _includes/head.html layout (Jekyll theme) or directly in your index.html. It's the strongest signal.
  2. llms.txt, llms-full.txt and robots.txt: place them at the root of your source branch (or the /docs folder, per Settings → Pages). They're served at the domain root.
  3. Fully static site (no Jekyll)? Add an empty .nojekyll file at the root. Keep the llms prefix: Jekyll ignores any file starting with _.

Verify it's live

Open your-site.com/llms.txt in a browser: you should see the file in plain text. Then test a page in Google's Rich Results Test to confirm the Q&A JSON-LD is detected. Until both checks pass, AI engines see nothing.

About the author

Joffrey

I built Citeable after watching sites pay a freelancer €95-100 for GEO done by hand. I wanted a tool that does it in 5 minutes, cleanly, and proves the result.

Analyze my site