Geordy AI - Generative Engine Optimization

Each 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 repository.

What are Link-rel Tags?

Link-rel tags are HTML elements that establish relationships between your current document and external resources. For Geordy, they tell AI crawlers and search engines where to find your structured data files.

Example Implementation

index.html

<head>
  <title>Your Website</title>
  <meta charset="UTF-8">
  
  <!-- Geordy AI References -->
  <link rel="alternate" href="https://geo.example.com/geordy.yaml" type="text/yaml">
  <link rel="alternate" href="https://geo.example.com/schema.json" type="application/ld+json">
  <link rel="alternate" href="https://geo.example.com/llms.txt" type="text/plain">
  <link rel="alternate" href="https://geo.example.com/feed.rss" type="application/rss+xml">
  <link rel="manifest" href="https://geo.example.com/manifest.json">
</head>

Link-rel Tags Reference

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

<head>

<title>Your Website</title>

</head>

geordy.yaml

rel="alternate" type="text/yaml"

schema.json

rel="alternate" type="application/ld+json"

llms.txt

rel="alternate" type="text/plain"

feed.rss

rel="alternate" type="application/rss+xml"

manifest.json

rel="manifest" type="application/json"

Best Practice: Always use absolute URLs (including https://) for maximum compatibility with AI crawlers and search engines.

Best Practices

Always Use Absolute URLs

Use full URLs including the protocol (https://) and domain. Relative paths may not be correctly interpreted by AI crawlers.

✓ Good: https://geo.example.com/geordy.yaml

✗ Bad: /geordy.yaml

Place in Head Section

Keep all link-rel tags inside <head> and above any <script> tags for optimal discovery.

Automatic Format Management

If a format is disabled in your Geordy dashboard, its corresponding link will be commented out automatically in the generated code snippet.

Complete Link-rel Reference

Format	Rel Attribute	Type Attribute
geordy.yaml	alternate	text/yaml
schema.json	alternate	application/ld+json
llms.txt	alternate	text/plain
feed.rss	alternate	application/rss+xml
manifest.json	manifest	application/json

For detailed installation instructions, see Install AI References.

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.

← Validation Tools JSON-LD Schema Reference →

Link-rel Reference Guide