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 
<link rel="alternate" type="application/yaml" href="https://geo.example.com/config.yaml" />
<link rel="alternate" type="text/markdown" href="https://geo.example.com/docs.md" />
<link rel="llms-txt" href="https://geo.example.com/llms.txt" />
<link rel="alternate" type="application/ld+json" href="https://geo.example.com/schema.json" />
<link rel="alternate" type="application/rss+xml" href="https://geo.example.com/feed.rss" />
 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
Install AI References interface showing HTML and JSON-LD manifest tabs with copy snippet button

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": "Example.com Structured Data",
  "description": "AI-optimized structured content for example.com",
  "url": "https://geo.example.com",
  "hasPart": [
    {
      "@type": "DataDownload",
      "encodingFormat": "application/yaml",
      "contentUrl": "https://geo.example.com/config.yaml"
    },
    {
      "@type": "DataDownload",
      "encodingFormat": "text/plain",
      "contentUrl": "https://geo.example.com/llms.txt"
    }
  ]
}

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.

Install page showing JSON-LD manifest with schema type and linked AI formats annotations
Next: Connect Your Custom Domain →
Ask Geordy