Setup & Onboarding

Install AI References

Add AI reference tags to your website's head section to enable AI crawler discovery.

What Are AI References?

AI References are two small code blocks that go inside your website's <head> tag that tell AI crawlers where to find your Geordy-generated files:

Once added, Geordy automatically keeps them current as your site evolves.

Install via HTML Head

1

Open Install → Tags (HTML)

Navigate to the Install section in Geordy and select the Tags (HTML) tab.
2

Copy the Link Tags

Click the Copy button to copy the full block of link-rel tags.
3

Paste into Your Website's <head>

Add the tags inside your site's <head> section, just before </head>.
4

Save and Publish

Deploy your changes to make the references live.

Example Link-Rel Block

<!-- Geordy AI References (homepage example) -->
<link rel="alternate" type="text/plain" href="https://ai.yourdomain.com/llms.txt" />
<link rel="alternate" type="text/plain" href="https://ai.yourdomain.com/humans.txt" />
<link rel="alternate" type="text/markdown" href="https://ai.yourdomain.com/index.md" />
<link rel="alternate" type="application/ld+json" href="https://ai.yourdomain.com/index.schema.json" />
<link rel="alternate" type="text/yaml" href="https://ai.yourdomain.com/index.yaml" />
<link rel="alternate" type="application/json" href="https://ai.yourdomain.com/index.og.json" />
<link rel="alternate" type="application/rss+xml" href="https://ai.yourdomain.com/index.xml" />
<link rel="manifest" href="https://ai.yourdomain.com/index.manifest.json" />
<!-- End Geordy AI References -->

Verification

  • View your site's source code and confirm the link-rel tags appear
  • Visit one of the referenced URLs (e.g. /llms.txt) — it should open successfully

Link-rel Tags Reference

Copy and paste these tags into your HTML <head> section

<head>
<title>Your Website</title>
<!-- 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" type="application/json">
</head>
llms.txtHomepage only
rel="alternate" type="text/plain"
humans.txtHomepage only
rel="alternate" type="text/plain"
index.mdEvery page
rel="alternate" type="text/markdown"
index.schema.jsonEvery page
rel="alternate" type="application/ld+json"
index.yamlEvery page
rel="alternate" type="text/yaml"
index.og.jsonEvery page
rel="alternate" type="application/json"
index.xmlEvery page
rel="alternate" type="application/rss+xml"
index.manifest.jsonEvery page
rel="manifest" type="application/json"
Best Practice: Always use absolute URLs (including https://) for maximum compatibility with AI crawlers and search engines.

Install via JSON-LD Manifest

1

Open Install → JSON-LD

Navigate to the JSON-LD tab in the Install section.
2

Copy the Manifest Script

Click Copy to copy the complete JSON-LD manifest.
3

Paste into Your Website's <head>

Add the script inside your site's <head> section.
4

Save and Publish

Deploy your changes to activate the manifest.

This manifest describes your entire dataset using @context and hasPart fields from Schema.org, giving AI systems a structured entry point.

Example JSON-LD Manifest

{
  "@context": "https://schema.org",
  "@type": "Dataset",
  "name": "yourdomain.com Structured Data",
  "description": "AI-optimized structured content for yourdomain.com",
  "url": "https://ai.yourdomain.com",
  "hasPart": [
    {
      "@type": "DataDownload",
      "encodingFormat": "text/plain",
      "contentUrl": "https://ai.yourdomain.com/llms.txt"
    },
    {
      "@type": "DataDownload",
      "encodingFormat": "text/markdown",
      "contentUrl": "https://ai.yourdomain.com/index.md"
    },
    {
      "@type": "DataDownload",
      "encodingFormat": "application/ld+json",
      "contentUrl": "https://ai.yourdomain.com/index.schema.json"
    },
    {
      "@type": "DataDownload",
      "encodingFormat": "text/yaml",
      "contentUrl": "https://ai.yourdomain.com/index.yaml"
    }
  ]
}

Verification

Use your browser's "View Source" and search for @type: Dataset to confirm the manifest is live. You can also use validation tools to verify the JSON-LD structure.

JSON-LD Schema Structure

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "What is GEO?",
  "author": {
    "@type": "Person",
    "name": "Geordy Team"
  },
  "datePublished": "2025-10-01"
}
Next: Connect Your Custom Domain →