JSON-LD for AI: Which Schema Types Matter Most
Structured data makes your content legible to machines — but not all schema types earn their keep. Organization, WebSite, and a Product/SoftwareApplication type are the foundation; FAQPage, Article, BreadcrumbList, and Person add depth. Here's what each does and the order to add them.
On this page▾
1What JSON-LD Is
JSON-LD is the recommended format for adding structured data — a script block that describes your content in machine-readable terms without changing how the page looks. It tells engines "this is an Organization named X," "this is a Product priced at Y," "this is a Question with this Answer." For AI search, that clarity matters: the less an engine has to guess about what you are, the more confidently it can surface and cite you.
It's part of the same toolkit as our FAQ schema walkthrough — this post zooms out to the full type list and how to prioritize.
2The Priority List
| Schema type | What it does | Priority |
|---|---|---|
| Organization | Who you are + sameAs entity links | Essential |
| WebSite | Site identity + search action | Essential |
| SoftwareApplication / Product | What you offer, pricing, features | Essential |
| FAQPage | Q&A as extractable pairs | High |
| Article / BlogPosting | Posts with dates + author | High |
| BreadcrumbList | Site hierarchy for navigation | Medium |
| Person | Author credentials (E-E-A-T) | Medium |
3Foundation Types (Do These First)
Three types establish who you are and what you offer — the identity layer AI needs to place you:
- Organization — your name, logo, and crucially
sameAslinks to your profiles (X, LinkedIn, GitHub, Product Hunt). This is how AI connects your site to your entity across the web. - WebSite — declares your site identity and can expose a search action.
- SoftwareApplication or Product — describes what you sell, with pricing (Offer) and features. For SaaS, SoftwareApplication; for physical goods, Product.
4Content Types (Add as You Publish)
- FAQPage — turns Q&A into extractable pairs; a natural fit for how AI quotes content.
- Article / BlogPosting — with
datePublished,dateModified, and author, it signals freshness and provenance. - BreadcrumbList — clarifies hierarchy and earns breadcrumb rich results.
- Person — links an author to their credentials, strengthening E-E-A-T; see E-E-A-T for AI visibility.
Free Schema Generator
Generate valid Organization, Product, FAQ, and Article JSON-LD to paste straight into your pages.
5A Minimal Example
Here's the single most important block to ship first — Organization with sameAs:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Your Company",
"url": "https://example.com",
"logo": "https://example.com/logo.png",
"sameAs": [
"https://x.com/yourcompany",
"https://www.linkedin.com/company/yourcompany",
"https://github.com/yourcompany"
]
}
</script>One rule underpins all of this: the schema must be in your server-rendered HTML and must match your visible content. Schema injected only after JavaScript runs is invisible to AI crawlers — see why AI crawlers can't see your JavaScript site.
Frequently Asked Questions
What is JSON-LD?
JSON-LD (JSON for Linking Data) is the recommended format for adding structured data to a web page. It's a script block that describes your content in machine-readable terms — what kind of entity it is, its name, properties, and relationships — without changing how the page looks. Search engines and AI systems read it to understand your content unambiguously.
Which schema types matter most for AI search?
Start with Organization (who you are, with sameAs links), WebSite (site identity), and either Product or SoftwareApplication (what you offer). Add FAQPage on Q&A content, Article/BlogPosting on posts with dates and author, BreadcrumbList for hierarchy, and Person for author credentials. Organization and the product type are the highest-priority foundation.
Does schema guarantee AI citations?
No. Schema removes ambiguity and reinforces meaning, which makes you easier to understand and cite — but it doesn't manufacture a citation on its own. It works alongside crawlable, citable content and authority. Think of it as making your content legible to machines, not as a ranking cheat code.
Where should JSON-LD go on the page?
In a script tag with type 'application/ld+json', in either the head or body. Critically, it must be in the server-rendered HTML — AI crawlers generally don't execute JavaScript, so schema injected only client-side is invisible to them. Validate it after deploy with a schema validator.
Should the schema match my visible content?
Yes, always. Structured data must describe content that genuinely appears on the page. Marking up content that isn't visible violates guidelines and can be ignored or penalized. Schema is a machine-readable mirror of your real content, not a place to add extra claims.