Appearance
Building an AI Discovery Page Fresh
The bridge between your main site and the AI layer. Copy-paste HTML template, required structured data, and how to connect your site to the network.
What Is an AI Discovery Page?
The AI Discovery Page (ADP) is a single page on your main site -- typically at /ai-discovery -- that serves as the hub connecting your human-facing website to your AI-readable data.
The ADP is the front door for AI crawlers and agents. One page, all your AI resources, connected to the network.
When an AI system or agent lands on your ADP, it finds:
- Links to all your AI-readable resources (llm-index.json, entities, sitemap, etc.)
- Structured data describing your AI layer
- Links to the LLM Disco Network and the LLM-LD spec
- A human-readable explanation for anyone who stumbles onto it
Important
The ADP lives on your main site, not your AI subdomain. It needs to be crawlable by everyone (allowed in robots.txt) so AI crawlers blocked from the rest of your site can still find it.
Minimum Requirements
To join the LLM Disco Network, your ADP needs:
- Page at
/ai-discoveryon your main site <link rel="llm-index">pointing to your llm-index.json (if using Layer 3)- JSON-LD structured data with
@type: "llmld:DiscoveryPage" - Links to the LLM-LD spec and LLM Disco Network
- List of your AI resources with URLs
- Human-readable description of what the page is
- Footer link on your main site:
🤖 AI-Optimized Websitepointing to/ai-discovery
Complete Template
Copy this template and customize it for your site:
html
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>YOUR_BUSINESS -- AI Discovery</title>
<meta name="description" content="Machine-readable AI layer discovery for YOUR_BUSINESS. Built on the LLM-LD open standard." />
<meta name="robots" content="index, follow" />
<link rel="canonical" href="https://YOUR_DOMAIN/ai-discovery" />
<!-- AI Resource Links -->
<link rel="llm-index"
type="application/json"
href="https://ai.YOUR_DOMAIN/.well-known/llm-index.json"
title="LLM-LD Index" />
<link rel="sitemap"
type="application/xml"
href="https://ai.YOUR_DOMAIN/sitemap.xml"
title="AI Sitemap" />
<link rel="ai-resource"
type="application/json"
href="https://ai.YOUR_DOMAIN/entities.json"
title="Entity Index"
data-resource-type="entities" />
<!-- Structured Data -->
<script type="application/ld+json">
{
"@context": ["https://schema.org", "https://llmld.org/v1"],
"@type": "llmld:DiscoveryPage",
"@id": "https://YOUR_DOMAIN/ai-discovery",
"name": "YOUR_BUSINESS -- AI Discovery",
"description": "AI layer discovery hub for YOUR_BUSINESS.",
"dateModified": "2026-01-01T00:00:00Z",
"isPartOf": {
"@type": "WebSite",
"name": "YOUR_BUSINESS",
"url": "https://YOUR_DOMAIN"
},
"llmld:aiLayer": {
"url": "https://ai.YOUR_DOMAIN",
"name": "YOUR_BUSINESS AI Layer",
"description": "Machine-readable version of public content."
},
"llmld:resources": [
{
"@type": "llmld:AIResource",
"identifier": "llm-index",
"name": "LLM-LD Index",
"url": "https://ai.YOUR_DOMAIN/.well-known/llm-index.json",
"encodingFormat": "application/json",
"description": "Complete site-wide machine-readable index.",
"category": "index",
"priority": 1
},
{
"@type": "llmld:AIResource",
"identifier": "ai-sitemap",
"name": "AI Sitemap",
"url": "https://ai.YOUR_DOMAIN/sitemap.xml",
"encodingFormat": "application/xml",
"description": "Full URL listing for AI-layer pages.",
"category": "sitemap",
"priority": 2
},
{
"@type": "llmld:AIResource",
"identifier": "entities",
"name": "Entity Index",
"url": "https://ai.YOUR_DOMAIN/entities.json",
"encodingFormat": "application/json",
"description": "Structured entity data.",
"category": "entities",
"priority": 3
}
]
}
</script>
</head>
<body>
<main>
<h1>YOUR_BUSINESS -- AI Discovery</h1>
<p>This page provides discovery links to YOUR_BUSINESS's machine-readable AI layer. It is intended for AI crawlers, agents, and developers.</p>
<h2>Resources</h2>
<ol>
<li>
<a href="https://ai.YOUR_DOMAIN/.well-known/llm-index.json">LLM-LD Index</a>
-- Complete site-wide machine-readable index
</li>
<li>
<a href="https://ai.YOUR_DOMAIN/sitemap.xml">AI Sitemap</a>
-- Full URL listing for AI-layer pages
</li>
<li>
<a href="https://ai.YOUR_DOMAIN/entities.json">Entity Index</a>
-- Structured entity data
</li>
</ol>
<h2>About This Standard</h2>
<p>This AI layer is built on <strong>LLM-LD</strong> (Large Language Model Linked Data) -- an open standard for making websites machine-readable to AI systems and agents.</p>
<p>Standard: llmld.org | Network: llmdisco.com</p>
<h2>Primary Site</h2>
<p><a href="https://YOUR_DOMAIN">YOUR_DOMAIN</a></p>
</main>
<footer>
<a href="https://YOUR_DOMAIN">YOUR_BUSINESS</a>
-- Standard: LLM-LD 1.0
-- Network: LLM Disco
</footer>
</body>
</html>Customize
Replace all instances of YOUR_BUSINESS and YOUR_DOMAIN with your actual values. Add or remove resources from the list based on what you've implemented.
Key Components Explained
Link Elements in Head
The <link> tags tell crawlers where your AI resources live:
rel="llm-index"-- Points to your llm-index.json (Layer 3)rel="sitemap"-- Your AI subdomain's sitemaprel="ai-resource"-- Other AI files (entities, knowledge graph, feeds)
JSON-LD Structured Data
Key fields:
@type: "llmld:DiscoveryPage"-- Identifies this as an ADPllmld:aiLayer-- URL and description of your AI subdomainllmld:resources-- Array of all your AI-readable files with metadata
Prohibited Practices
- DO NOT use
rel="alternate"for AI-layer resources.alternatemeans "same content, different format," which is semantically wrong. - DO NOT use
rel="preload"orrel="prefetch"for AI-only resources.
Adding More Resources
If you have additional AI resources, add them to both the <link> tags and the llmld:resources array:
- Knowledge Graph --
knowledge-graph.json - LLMs Manifest --
llms.txt(plain-text summary) - Services Feed -- Real-time service listings
- Articles Feed -- Blog posts and articles
- Products Feed -- E-commerce product data
The Footer Link
Add a link to your AI Discovery Page in the footer of your main site:
html
<a href="/ai-discovery">🤖 AI-Optimized Website</a>Why this matters: Many AI systems currently find content through search engines, not direct crawling. A footer link on every page maximizes the chance your ADP gets indexed and found.
Exact Match Required
The network checks for this link automatically during verification. The emoji and text must match exactly: 🤖 AI-Optimized Website. Variations won't pass verification.
After You Publish
- Verify it's accessible: Visit
yoursite.com/ai-discoveryin a browser - Check robots.txt: Make sure
/ai-discoveryis allowed for all crawlers - Verify footer link: Confirm
🤖 AI-Optimized Websiteappears in your site footer - Validate the structured data: Use the Schema Validator
- Submit to the network: Go to llmdisco.com and enter your URL