Link-rel Reference Guide
Learn how to reference your generated files in your website's HTML head using link-rel tags.
Each Geordy-generated file is referenced in your website's <head> via link-rel tags. This is the bridge between your live site and its structured data files — it tells AI crawlers exactly where to look.
How file paths work
Geordy generates files whose paths mirror your existing site structure. The base is always your Geordy subdomain (e.g. ai.yourdomain.com) or Geordy's hosted address (files.geordy.ai/yourdomain.com). Two files live at the root only: llms.txt and humans.txt. All other formats use an index.* naming convention for the homepage, and mirror your page path for inner pages.
Root-only files (homepage)
https://ai.yourdomain.com/llms.txt https://ai.yourdomain.com/humans.txt
Homepage structured files
https://ai.yourdomain.com/index.md https://ai.yourdomain.com/index.schema.json https://ai.yourdomain.com/index.yaml https://ai.yourdomain.com/index.og.json https://ai.yourdomain.com/index.xml https://ai.yourdomain.com/index.manifest.json
Inner page — e.g. /about/team
https://ai.yourdomain.com/about/team.md https://ai.yourdomain.com/about/team.schema.json https://ai.yourdomain.com/about/team.yaml https://ai.yourdomain.com/about/team.og.json https://ai.yourdomain.com/about/team.xml https://ai.yourdomain.com/about/team.manifest.json
Don't have a custom subdomain? Replace ai.yourdomain.com with files.geordy.ai/yourdomain.com — the paths are identical.
Example — homepage link-rel block
<!-- Geordy AI References -->
<link rel="alternate" href="https://ai.yourdomain.com/llms.txt" type="text/plain">
<link rel="alternate" href="https://ai.yourdomain.com/humans.txt" type="text/plain">
<link rel="alternate" href="https://ai.yourdomain.com/index.md" type="text/markdown">
<link rel="alternate" href="https://ai.yourdomain.com/index.schema.json" type="application/ld+json">
<link rel="alternate" href="https://ai.yourdomain.com/index.yaml" type="text/yaml">
<link rel="alternate" href="https://ai.yourdomain.com/index.og.json" type="application/json">
<link rel="alternate" href="https://ai.yourdomain.com/index.xml" type="application/rss+xml">
<link rel="manifest" href="https://ai.yourdomain.com/index.manifest.json">Example — inner page (/pricing)
<!-- Geordy AI References -->
<link rel="alternate" href="https://ai.yourdomain.com/pricing.md" type="text/markdown">
<link rel="alternate" href="https://ai.yourdomain.com/pricing.schema.json" type="application/ld+json">
<link rel="alternate" href="https://ai.yourdomain.com/pricing.yaml" type="text/yaml">
<link rel="alternate" href="https://ai.yourdomain.com/pricing.og.json" type="application/json">
<link rel="alternate" href="https://ai.yourdomain.com/pricing.xml" type="application/rss+xml">
<link rel="manifest" href="https://ai.yourdomain.com/pricing.manifest.json">Link-rel Tags Reference
Copy and paste these tags into your HTML <head> section
Dynamic sitewide implementation
Rather than adding tags manually to every page, you can add one dynamic template to your global <head> that constructs the correct file URL from the current page path automatically. Every page on your site will then point to its own Geordy files — including pages you haven't generated yet.
// In your root layout or _document.tsx
const pagePath = usePathname() // e.g. "/about/team"
const isHome = pagePath === "/"
const fileBase = isHome ? "index" : pagePath.replace(/^//, "").replace(//$/, "")
const geoBase = `https://ai.yourdomain.com/${isHome ? "" : fileBase.split("/").slice(0, -1).join("/") + "/"}`
const fileName = isHome ? "index" : fileBase.split("/").at(-1)
// Then in <head>:
// <link rel="alternate" href={`${geoBase}${fileName}.md`} type="text/markdown" />
// ... repeat for each formatBest Practices
Always use absolute URLs
Use full URLs including the protocol and domain. Relative paths may not be correctly interpreted by AI crawlers.
✓ https://ai.yourdomain.com/index.md
✗ /index.md
Place in <head>, before scripts
Keep all link-rel tags inside <head> and above any <script> tags for optimal discovery.
llms.txt and humans.txt belong on the homepage only
These are root-level files — add their link-rel tags only to your homepage <head>, not to inner pages.
Complete file reference
| File | Rel | Type | Scope |
|---|---|---|---|
| llms.txt | alternate | text/plain | Homepage only |
| humans.txt | alternate | text/plain | Homepage only |
| [page].md | alternate | text/markdown | Every page |
| [page].schema.json | alternate | application/ld+json | Every page |
| [page].yaml | alternate | text/yaml | Every page |
| [page].og.json | alternate | application/json | Every page |
| [page].xml | alternate | application/rss+xml | Every page |
| [page].manifest.json | manifest | application/json | Every page |
Troubleshooting
If your link-rel tags aren't working as expected, check the following:
- Verify the URLs are accessible (return HTTP 200)
- Ensure tags are placed in the
<head>section - Check for typos in the href or type attributes
- Confirm your custom domain is properly configured
For more help, see Tags or JSON-LD Missing.
Next Steps
Learn more about the JSON-LD Schema format and how it structures your content for search engines.