TechnicalUpdated November 4, 20266 min read

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 sameAs links 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, and dateModified.
  • 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 sameAs links or a generic description borrowed from a competitor.
  • Stale dates, dateModified frozen 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?
No evidence shows that schema alone produces citations. It helps systems resolve your entity and read your facts without guessing, which removes one source of error, whether you are cited still depends on content depth, clarity, and relevance to the question being asked.
Which schema type should a services firm add first?
Organization on the homepage, then Service on each core offer page, then FAQPage wherever you have a visible FAQ block. Those three cover identity, offer, and buyer questions, which are the facts an assistant needs to describe you accurately.
Can I put FAQ schema on a page without a visible FAQ?
No. Search guidelines require that marked-up content be visible on the page, and hidden or mismatched FAQs are a common reason for manual actions. Put the questions and answers on the page first, then mirror them exactly in the JSON-LD.
How is JSON-LD different from meta tags?
Meta tags carry a few flat fields, title, description, while JSON-LD expresses relationships: a company provides a service, a service has an area served, an article has an author and dates. It is richer, but it must still match what the page says in visible text.

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.