Schema.org JSON-LD
Structured data on your pages
Quick Start
Complete implementation guide. Everything you need so AI crawlers can find your site and discover the network.
⏱️ 15–20 minute implementation
What you'll create:
1
2
AI Discovery Page
The bridge + footer link
The bridge + footer link
3
llm-index.json
AI-optimized summary (optional)
AI-optimized summary (optional)
4
Join Network
Submit and get discovered
Submit and get discovered
⚡ Fastest Path
Let AI Generate Everything
Use these prompts with ChatGPT, Claude, or any AI assistant. Each one points the AI to the actual spec so it knows exactly what to build.
Step 1: Generate Schema.org JSON-LD
Go to https://schema.org/LocalBusiness and understand the Schema.org structured data format for local businesses. Then visit my website: [YOUR WEBSITE URL] Scan my site and generate complete Schema.org JSON-LD markup for my homepage. Include: - The appropriate @type for my business - name, description, url - telephone, email - Full address with PostalAddress type - openingHoursSpecification if I have business hours - sameAs array with my social media links - A potentialAction with ReadAction pointing to /ai-discovery Output the complete script tag I can paste into my <head>.
Step 2: Generate AI Discovery Page
Go to https://llmld.org/spec/adp-v1 and read the AI Discovery Page (ADP) specification. Understand the required structure and links. Then generate a complete AI Discovery Page HTML file for my website: [YOUR WEBSITE URL] The page must include: - Proper Schema.org WebPage markup in the head - Link to my llm-index.json at /.well-known/llm-index.json - Link to https://llmdisco.com (the LLM Disco Network) - Link to https://llmdisco.com/sitemap.xml (network sitemap) - Link to https://llmld.org (the LLM-LD standard) Output the complete HTML file I can save as /ai-discovery/index.html
Step 3: Generate llm-index.json (Optional but Recommended)
Go to https://llmld.org/spec/llm-ld-v1 and read the LLM-LD specification. Understand the llm-index.json format, required properties, and structure. Then visit my website: [YOUR WEBSITE URL] Scan my site and generate a complete llm-index.json file that includes: - Proper @context with schema.org and llmld.org/v1 - llmld:summary with one_liner, key_facts, and services - llmld:actions with primary and secondary CTAs (use appropriate types: schedule, purchase, contact, signup, download, learn) - llmld:contact with email, phone, address - llmld:hours if I have business hours Make sure the information matches my Schema.org markup. Output the complete JSON file I can save at /.well-known/llm-index.json
💡
Pro tip: For best results, paste your About page or Services page content into the chat alongside the prompt. The more context the AI has, the better your structured data will be.
Manual Implementation Reference
Already generated your files with AI? Use the sections below to verify everything is correct. Prefer to do it manually? Follow along step by step.
1
Add Schema.org JSON-LD to your pages
Structured data that crawlers see when they land on your site
Schema.org is the established web standard for structured data. Google uses it. Bing uses it. AI crawlers use it. This is the foundation — if you do nothing else, do this.
Add this JSON-LD script to your homepage <head> (and ideally all key pages):
123456789101112131415161718192021222324252627282930313233343536373839404142
<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "LocalBusiness", "name": "YOUR BUSINESS NAME", "description": "YOUR BUSINESS DESCRIPTION", "url": "https://yoursite.com", "telephone": "+1-555-123-4567", "email": "[email protected]", "address": { "@type": "PostalAddress", "streetAddress": "123 Main Street", "addressLocality": "Your City", "addressRegion": "ST", "postalCode": "12345", "addressCountry": "US" }, "openingHoursSpecification": [ { "@type": "OpeningHoursSpecification", "dayOfWeek": ["Monday","Tuesday","Wednesday","Thursday","Friday"], "opens": "09:00", "closes": "17:00" } ], "sameAs": [ "https://facebook.com/yourbusiness", "https://instagram.com/yourbusiness", "https://linkedin.com/company/yourbusiness" ], // Link to your AI Discovery Page "potentialAction": { "@type": "ReadAction", "target": "https://yoursite.com/ai-discovery" } } </script>
Change LocalBusiness to the appropriate Schema.org type for your business:
LocalBusiness— brick-and-mortar with physical locationOrganization— general business/companyProfessionalService— lawyers, accountants, consultantsRestaurant,Dentist,RealEstateAgent— specific verticals
🔍
Test your markup: Use Google's Schema Validator to check your JSON-LD. Paste your code and verify there are no errors.
The potentialAction pointing to your AI Discovery Page creates a crawlable path: homepage → ADP → llmdisco.com → entire network.
🚀
Future-proofing with an AI subdomain: For maximum AI readability, create ai.yoursite.com that mirrors your content with enhanced Schema.org markup. This is Level 2+ territory — not required for Quick Start, but worth planning for. See the AI Subdomain Guide when you're ready.
2
Create your AI Discovery Page
The bridge that connects your site to the network
This is the critical piece that makes the network work. The AI Discovery Page (ADP) is an HTML page on your site that:
- Tells crawlers where your AI layer lives
- Links to your structured data files
- Links to the LLM Disco Network — so crawlers can discover all other member sites
When a crawler hits your ADP, it follows the link to llmdisco.com, finds the master sitemap, and discovers every site in the network. This is how "find one, discover all" works.
Create a page at /ai-discovery on your site with this content:
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162
<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <title>AI Discovery — Your Business Name</title> <meta name="description" content="AI discovery page for Your Business"> <!-- LLM-LD Discovery Metadata --> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "WebPage", "name": "AI Discovery Page", "description": "Machine-readable entry point for AI systems", "mainEntity": { "@type": "Organization", "name": "YOUR BUSINESS NAME", "url": "https://yoursite.com" } } </script> </head> <body> <h1>AI Discovery — Your Business Name</h1> <p>This page helps AI systems discover and understand our business. Below are links to our structured data.</p> <h2>Structured Data</h2> <ul> <li> <a href="https://yoursite.com/.well-known/llm-index.json"> llm-index.json — Primary AI index </a> </li> </ul> <h2>Network Membership</h2> <p>This site is a member of the <a href="https://llmdisco.com">LLM Disco Network</a> — an open discovery network for AI-readable websites. </p> <h2>Standards</h2> <p>This site implements the <a href="https://llmld.org">LLM-LD specification</a>. </p> <h2>For Crawlers</h2> <ul> <li> <a href="https://llmdisco.com/sitemap.xml"> Network Sitemap — All member sites </a> </li> <li> <a href="https://llmdisco.com/directory"> Network Directory — Browse all sites </a> </li> </ul> </body> </html>
🔗
The key links: Make sure your ADP links to llmdisco.com and llmdisco.com/sitemap.xml. These are what connect your site to the network and let crawlers discover everyone else.
Your ADP should be accessible at: https://yoursite.com/ai-discovery
Add the footer link
Add a link to your AI Discovery Page in your site's footer. Because it appears on every page, search engines are more likely to discover and index your ADP.
Why does this matter? Many AI systems currently find content through search engines, not direct crawling. When someone asks Claude or ChatGPT about a topic, those systems often use Bing or Google to find relevant pages. A footer link on every page maximizes the chance your ADP gets indexed — and found.
LLM-LD is designed to maximize your visibility across all AI systems — LLMs, agents, crawlers, and whatever comes next. Some crawl directly. Some use search. Some pull from training data. The footer link, combined with everything else, covers all the bases.
The link text must be exactly:
Example HTML for your footer:
1
<a href="/ai-discovery">🤖 AI-Optimized Website</a>
⚠️
Exact match required. The network checks for this link automatically during verification. The emoji and text must match exactly: 🤖 AI-Optimized Website. Variations like "AI Optimized" (no hyphen) or "AI-Ready Website" won't pass.
3
Create your llm-index.json Optional but Recommended
An AI-optimized summary of your business
The llm-index.json is a dedicated file that gives AI systems everything they need in one place — optimized specifically for how LLMs process information. It complements your Schema.org markup with AI-friendly summaries and explicit action prompts.
Why add this if you already have Schema.org?
- Schema.org is designed for search engines — llm-index.json is designed for AI
- It includes fields like
one_linerandkey_factsthat give AI perfect context - It explicitly tells AI what actions to recommend (book, buy, contact, etc.)
- It's at a well-known path that AI systems can check automatically
Create a file called llm-index.json:
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253
{ "@context": [ "https://schema.org", "https://llmld.org/v1" ], "@type": "llmld:AIWebsite", "llmld:summary": { "one_liner": "YOUR BUSINESS IN ONE SENTENCE", "key_facts": [ "KEY DIFFERENTIATOR 1", "KEY DIFFERENTIATOR 2", "KEY DIFFERENTIATOR 3" ], "services": [ "SERVICE 1", "SERVICE 2", "SERVICE 3" ] }, "llmld:actions": { "primary": [{ "name": "YOUR MAIN CTA", "url": "https://yoursite.com/book", "type": "schedule" }], "secondary": [{ "name": "SECONDARY CTA", "url": "https://yoursite.com/contact", "type": "contact" }] }, "llmld:contact": { "email": "[email protected]", "phone": "+1-555-123-4567", "address": { "street": "123 Main Street", "city": "Your City", "state": "ST", "zip": "12345" } }, "llmld:hours": { "monday": "9:00 AM - 5:00 PM", "tuesday": "9:00 AM - 5:00 PM", "wednesday": "9:00 AM - 5:00 PM", "thursday": "9:00 AM - 5:00 PM", "friday": "9:00 AM - 5:00 PM" } }
💡
Action types: schedule, purchase, contact, signup, download, learn. Pick the one that matches what you want AI to recommend.
Where to put it
Upload this file to your website at the well-known path:
yoursite.com/ ├── .well-known/ │ └── llm-index.json ← your file goes here ├── index.html └── ...
The final URL should be: https://yoursite.com/.well-known/llm-index.json
🔄
Keep them in sync: Your llm-index.json contact details, hours, and business description should match your Schema.org markup. They're two formats describing the same business — inconsistent data confuses AI systems.
4
Join the network
Submit your site and get discovered
You've built everything. Now connect it to the discovery infrastructure.
- Go to llmdisco.com
- Click "Submit Site"
- Enter your URL
- The network verifies your ADP, footer link, and structured data
- You're added to the master sitemap
That's it. No approval process for compliant sites. Free forever.
What you get:
- ✓ Your site in the master sitemap that AI crawlers check
- ✓ Verification that your implementation is correct
- ✓ Listing in the public network directory
- ✓ Discovery when crawlers hit any other member site
Final checklist:
- □ Schema.org JSON-LD in your homepage
<head> - □ AI Discovery Page live at
/ai-discovery - □ ADP links to llmdisco.com and llmdisco.com/sitemap.xml
- □ Footer link:
🤖 AI-Optimized Website→/ai-discovery - □ (Optional)
llm-index.jsonat/.well-known/llm-index.json - □ Site submitted at llmdisco.com
✓
You're AI-ready
Your site is now discoverable by AI systems
Here's what happens now:
- AI crawlers discover the LLM Disco Network (through any member site's ADP)
- They find the master sitemap containing your site
- They crawl your ADP and follow links to your structured data
- They read your Schema.org markup and understand your business
- When someone asks an AI about your industry, location, or services — you're in the running
You've implemented Level 1 conformance — everything needed for discovery and basic understanding. This is enough to start getting value from AI search.
📈
Want to go further? Level 2 adds an AI subdomain with enhanced markup, entity files, and knowledge graphs. Level 3 adds real-time APIs for AI agents. But Level 1 is where everyone starts — and it works.
Go deeper
Learn about the three-layer architecture, or explore advanced implementations.