Troubleshooting & FAQs

Tags or JSON-LD Missing

Fix missing AI references in your HTML head section to ensure proper AI crawler communication.

If AI references don't appear in your site's source, Geordy can't communicate with AI crawlers. This guide will help you properly install the required tags.

Missing AI References

Common symptoms of this issue

Missing <link rel="alternate"> or <script type="application/ld+json"> tags in your HTML

"AI References not detected" warning in dashboard

Validation tools can't find references

Steps to Fix

1

Review Installation Guide

Revisit the AI References installation documentation for complete instructions.
Install AI References Guide →
2

Copy HTML Tags

Copy the full block from the Install → Tags (HTML) section in your dashboard.
 AI References - Geordy 
<link rel="alternate" type="application/yaml" href="https://geo.example.com/page.yaml" />
<link rel="alternate" type="text/markdown" href="https://geo.example.com/page.md" />
<link rel="alternate" type="text/plain" href="https://geo.example.com/llms.txt" />
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WebPage",
  "name": "Your Page Title",
  "url": "https://example.com/page"
}
</script>
3

Insert Into Head Section

Paste the copied code inside your website's <head> tag, before the closing </head>.
4

Publish Changes

Save and publish your website changes to make the tags live.
5

Verify Installation

View your page source and search for the AI references.

How to check:

  1. 1. Visit your website in a browser
  2. 2. Right-click and select "View Page Source"
  3. 3. Press Ctrl + F (or Cmd + F) and search for "llms.txt" or "@type"
  4. 4. Confirm both link-rel tags and JSON-LD script appear

Fixing Missing AI References

Step-by-step guide to install tags correctly

Problem Detected

AI references missing from HTML

<head>
<title>Your Website</title>
← Missing AI references here!
</head>
Step 1 of 4

Platform-Specific Instructions

WordPress:

Add the code to your theme's header.php file or use a plugin like "Insert Headers and Footers" to add custom code to the head section.

Shopify:

Edit your theme's theme.liquid file and paste the code before the closing </head> tag.

Webflow:

Go to Project Settings → Custom Code → Head Code and paste the AI references there.

Custom HTML:

Directly edit your HTML files and add the code to the <head> section.

← Formats Not UpdatingNext: Processing Queue Stuck →
Ask Geordy