Learn

Guide

Geordy in plain English - what it does, what you get, how to use it.

What you get

Geordy takes a page from your site and produces extra machine-readable versions of it - so AI systems can understand what the page means without guessing. Your site looks the same to visitors. You're just adding a clean, structured layer for machines.

The platform generates eight file formats per page:

  • Markdown (.md) - clean page version for AI
  • Schema JSON - structured "meaning" data
  • - clear site rules for LLMs (homepage only)
  • - lightweight structured data
  • OG.json - Open Graph metadata as JSON
  • RSS (.xml) - feed format for updates
  • manifest.json - app manifest metadata
  • humans.txt - human-readable credits file (homepage only)

The shortest path to value

Five steps, and one of them is optional.

1. Pick one page

Homepage, top landing page, pricing, or your best product or category page. Drop the URL into Geordy and generate the formats.

2. Enable the right formats

Start with Schema JSON, Markdown, and llms.txt (homepage only). Add OG.json, YAML, RSS, manifest, and humans.txt when you're ready.

3. Put files somewhere accessible

Two options. Option A: use Geordy's URL directly. Your files are already live at Geordy's address the moment they're generated - files.geordy.ai/yourdomain.com/llms.txt. Option B (optional): your own subdomain via one DNS pointing at 178.156.151.211. This puts the files under your own brand rather than ours. Nothing waits on it: your files are already serving from Option A.

4. Verify it works

Open your files in a browser: files.geordy.ai/yourdomain.com/llms.txt, or ai.yourdomain.com/llms.txt if you added the subdomain. If it loads, you are done.

5. Add reference tags

Insert <link rel="alternate"> tags in the page <head> so AI crawlers can discover the structured files.

Homepage (8 files)html
<link rel="alternate" href="https://ai.yourdomain.com/llms.txt" />
<link rel="alternate" href="https://ai.yourdomain.com/humans.txt" />
<link rel="alternate" href="https://ai.yourdomain.com/index.md" />
<link rel="alternate" href="https://ai.yourdomain.com/index.schema.json" />
<!-- + index.yaml, index.og.json, index.xml, index.manifest.json -->
Inner pages (6 files)html
<link rel="alternate" href="https://ai.yourdomain.com/about.md" />
<link rel="alternate" href="https://ai.yourdomain.com/about.schema.json" />
<!-- + about.yaml, about.og.json, about.xml, about.manifest.json -->
NoteThe slug matches the page path. /about → about.md, /pricing → pricing.md.

Post-deployment verification

  1. DNS working - visit ai.yourdomain.com/llms.txt in your browser; the file should load.
  2. Tags installed - view page source, search for "llms.txt" or your subdomain; the tags should appear in <head>.
  3. Files accessible - click through each file URL; all should return content (not 404).

How URLs map

Two files live only on the homepage: /llms.txt and /humans.txt. Everything else mirrors your site paths.

Homepage files

  • ai.yourdomain.com/index.md
  • ai.yourdomain.com/index.schema.json
  • ai.yourdomain.com/index.yaml
  • ai.yourdomain.com/index.og.json
  • ai.yourdomain.com/index.xml
  • ai.yourdomain.com/index.manifest.json

Inner page example (/about/team)

  • ai.yourdomain.com/about/team.md
  • ai.yourdomain.com/about/team.schema.json
  • ai.yourdomain.com/about/team.yaml
  • ai.yourdomain.com/about/team.og.json
  • ai.yourdomain.com/about/team.xml
  • ai.yourdomain.com/about/team.manifest.json

Scaling up

  1. Top 5 rollout - homepage, pricing, top category, top product, about/credibility page first.
  2. import - once working, import your XML sitemap and process in batches, prioritizing money pages.
  3. Dynamic link tags - add a single template to your global <head> that builds file URLs from the current page path automatically.
  4. Keep a refresh cadence on pages that change. Set a page's Frequency to Off once you have edited one of its formats by hand and want it to hold.
  5. Fix the source page first. If a generated format feels wrong, the original page is usually unclear to machines. Fix the page, regenerate.
Dynamic patternhtml
<link rel="alternate" href="https://ai.{domain}/{slug}.md" />

Where {slug} equals the current page path or "index" for the homepage. Tags auto-generate for every page; new pages are covered automatically; no manual updates needed.

Related
FormatsThe eight file types Geordy generates, what each one does, and when to use it.SetupAdd your site, Geordy writes the files, Add the link tags.
Guide | Geordy Docs