Schema Markup for AI Discovery: The JSON-LD Types That Matter
JSON-LD is structured data that names your entities for machines: who you are (Organization), what you sell (Service), and what buyers ask (FAQPage). It helps AI systems resolve your business to a consistent fact set instead of guessing. Start with those three, but schema must mirror visible page content, and schema alone is not a strategy.
Key takeaways
- JSON-LD states your facts in a vocabulary machines already share, which reduces ambiguity when a system resolves your entity.
- For a services firm, ship Organization, Service, and FAQPage first, identity, offer, and buyer questions.
- Schema must mirror visible page content exactly; hidden or mismatched FAQs violate guidelines and get ignored or penalized.
- Schema alone is not a strategy, clarity of content is, and schema makes that clarity machine-legible.
- The audit scores structured data under Data Quality; AEO vs SEO covers the wider picture.
Why JSON-LD helps machines
When a model reads your homepage it has to infer the basics: company name, category, location, services, price range, who to contact. JSON-LD removes the inference. It is a JSON block embedded with <script type="application/ld/json"> in the page, stating facts in a vocabulary machines already share, schema.org, so the same information is available whether the reader is a search engine, an assistant resolving an entity, or an agent building a vendor list.
The benefit is resolution, not magic. Structured data does not rank you and does not, by itself, get you cited. It reduces ambiguity at the moment a system decides what your business is and which claims belong to you, and ambiguity is exactly what makes an assistant hedge, merge you with a competitor, or leave you out of the answer.
The type list is long, but the ranking for AI discovery is short:
- Organization, name, logo, URL, contact points, and
sameAslinks to your profiles. This is your entity record; without it every other type floats. - Service, one per core offering: name, provider, area served, and a description that matches your page copy.
- FAQPage, question and answer pairs that mirror the visible FAQ block on the page.
- WebSite, site name and identity. Low effort, useful context.
- WebPage and BreadcrumbList, help a system place a page inside your site hierarchy.
- Article or BlogPosting, for guides and posts: headline, author,
datePublished, anddateModified. - Product or Offer, only if you sell a defined item with a price; not for intangible services without a concrete offer.
What to implement first
Order of operations matters more than volume. If you implement three things, implement Organization on the homepage, Service on each core offer page, and FAQPage wherever you have a visible FAQ block. That covers identity, offer, and buyer questions, the three facts an assistant needs before it can describe you accurately.
Then expand along the same rule: one type per page, describing only what that page shows. A Service block belongs on the service page, not repeated on every URL. A FAQPage block belongs under questions a visitor can actually read without clicking anything. Sites that spray one WebPage full of everything from the rest of the site are describing a page that does not exist.
A compact Organization example
Drop this into the <head> of your homepage, then replace every value:
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Your Company",
"url": "https://example.com",
"logo": "https://example.com/logo.png",
"description": "One sentence on what you do and for whom.",
"contactPoint": { "@type": "ContactPoint", "contactType": "sales", "email": "hello@example.com" },
"sameAs": ["https://www.linkedin.com/company/yourcompany"]
}
Then add a Service block to each service page and a FAQPage block to your FAQ page, reusing the same identifiers. Every value must be byte-identical to what the page shows: if the visible copy says $2,500, the schema says $2,500, not $2500 and not "from $2500".
The rules that keep schema honest
Structured data is a formal claim about your page, and mismatched claims are treated as spam signals. The failures we see most often:
The operating rule is simple: the page is the source of truth, and the schema describes it. Google's AI optimization guide frames it the same way, structured data helps systems understand your content, but it is one input among many, not a ranking switch.
- Schema for invisible content, FAQ answers that exist in JSON-LD but never appear on the page. This violates guidelines and can trigger manual actions.
- Mismatched FAQs, the page shows four questions, the schema shows seven, or the wording differs enough that they are not the same questions.
- Copy-paste identity, Organization data carrying another firm's
sameAslinks or a generic description borrowed from a competitor. - Stale dates,
dateModifiedfrozen at launch while the page changed three times since. - Everything on one page, services from across the site stuffed into a single homepage block.
Schema is not a strategy
Honest limit: perfect JSON-LD on an unclear message changes nothing. We have seen flawless schema on sites whose positioning is mush, three service names that mean the same thing, pricing hidden behind a contact form, claims that contradict the homepage. Machines resolve entities; they do not fix your message. Clarity of content is the strategy, and schema is how you make that clarity machine-legible.
Run the audit to see whether your schema exists, matches the visible copy, and covers Organization, Service, and FAQPage, it feeds the Data Quality score, alongside roughly 40 other checks and a prioritized fix list. For the wider picture, AEO vs SEO explains what structured data does and does not move, and this layer ships as part of our services.
Frequently asked questions
Does schema markup get me cited by AI assistants?
Which schema type should a services firm add first?
Can I put FAQ schema on a page without a visible FAQ?
How is JSON-LD different from meta tags?
Put this guide to work on your site.
Run the free audit for an instant score and prioritized fix list, or book a 30-minute call and we scope the work for you.
We do not guarantee AI citations, rankings, traffic, leads, revenue, or purchases.
Related guides
Foundations · 7 min read
AEO vs SEO: What Changes in the AI Search Era
SEO earns rankings in search results; AEO makes your content understandable and usable by AI assistants and agents. Where they overlap, where they diverge.
Foundations · 7 min read
How AI Assistants See Your Website (From Crawl to Citation)
The four steps between your site and an AI answer, crawler access, retrieval, comprehension, and citation, and what degrades each one.
Playbooks · 8 min read
Agent-Ready Website Checklist: 27 Checks Before You Publish
A 27-point checklist for AI search readiness, grouped by Discovery, Data Quality, and Actionability: robots.txt, schema, pricing, docs, and agent-safe actions.