Schema markup

nounalso called structured data, JSON-LD or schema.org markup

Definition

Schema markup is structured data, usually written as JSON-LD with the Schema.org vocabulary, that labels what a page contains — an article, a product, an organization, a local business — so search engines can interpret it unambiguously and show it as rich results.

Updated 6 min read8 cited sources

On this page8 sections

Why it matters for founders and small teams

Schema markup is the most over-promised fix in AI search: it’s cheap to add, easy to sell, and the largest test so far found it barely moved AI citations. For a small team the useful version is short — a few accurate types that earn rich results and make your brand unambiguous — which leaves the rest of your week for the visible content engines actually quote.

How does schema markup work?#

Schema markup works by adding a block of machine-readable data, usually JSON-LD inside a <script type="application/ld+json"> tag, that names each thing on a page with Schema.org types and properties — an Article with an author and dates, a Product with a price — so a parser doesn’t have to infer it from the prose.

Schema.org is a shared vocabulary founded by Google, Microsoft, Yahoo and Yandex. JSON-LD is the format Google recommends, because it sits apart from the visible HTML and is easy to maintain. Google says it uses structured data “to understand the content of the page” and, for supported types, to show rich results such as prices, ratings and event dates in the listing.

html
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "How to plan a product launch with a five-person team",
"datePublished": "2026-09-01",
"dateModified": "2026-09-18",
"author": {
"@type": "Person",
"name": "Jordan Lee",
"url": "https://plannora.io/team/jordan-lee"
},
"publisher": {
"@type": "Organization",
"name": "Plannora",
"url": "https://plannora.io",
"logo": "https://plannora.io/logo.png",
"sameAs": [
"https://www.linkedin.com/company/plannora",
"https://www.youtube.com/@plannora"
]
}
}
</script>

Two rules from Google’s guidelines matter more than which types you pick. Mark up only what readers can see: “don’t add structured data about information that is not visible to the user, even if the information is accurate.” And supply “fewer but complete and accurate” properties rather than every optional one. Validate with the Rich Results Test for Google features and the Schema Markup Validator for the rest.

Schema markup has no confirmed effect on AI citations: Google says AI Overviews and AI Mode need no special schema, and a 2026 Ahrefs test of 1,885 pages found that adding JSON-LD produced no meaningful lift in ChatGPT, AI Mode or AI Overviews citations.

+2.2%

change in ChatGPT citations after 1,885 already-cited pages added JSON-LD — statistically indistinguishable from zero

Ahrefs, May 2026

−4.6%

change in Google AI Overview citations for the same pages, measured against 4,000 control pages

Ahrefs, May 2026

3.6 vs 4.2

average ChatGPT citations for pages with FAQ schema versus pages without it

SE Ranking
  • Google: not required for AI features

    Official

    Google’s AI optimization guide: “Structured data isn’t required for generative AI search, and there’s no special schema.org markup you need to add.” It still recommends schema for rich results.

  • Microsoft: it helps its LLMs understand pages

    Official

    At SMX Munich in March 2025, Bing’s Fabrice Canel was reported as saying schema markup helps Microsoft’s LLMs understand content. No effect on Copilot citations has been published.

  • Text-only fetchers may never see it

    Our read

    Anthropic’s web fetch returns page text, so a fact that exists only in JSON-LD may never reach Claude. State every marked-up fact in the visible copy as well.

  • The test covered pages already being cited

    Observed

    Every page in the Ahrefs sample had 100+ AI Overview citations before adding schema, so the finding applies to pages already in the consideration set — not to pages engines haven’t picked up yet.

Rankbox framework

The Three-Job Schema Test

Before adding or keeping any schema type, ask which of three jobs it does. Markup that does none of them is maintenance with no return, and markup that contradicts the page is a liability.

  1. 01

    Job 1: it earns a rich result Google still shows

    Check the type against Google’s current search gallery, not an old blog post. Product, Review snippet, Recipe, Event, Video, Local business and Software app qualify; FAQPage and HowTo no longer do.

  2. 02

    Job 2: it makes an entity unambiguous

    Organization and Person with sameAs links tie your brand and authors to profiles engines already know. Microsoft has said schema helps its LLMs understand content; no engine has confirmed an effect on citations.

  3. 03

    Job 3: it mirrors the visible text exactly

    Every value in the JSON-LD — price, date, author, rating — appears on the page in the same form. Engines that read only text never see the markup, so the visible copy has to carry each fact on its own.

How to use it: Keep a type only if it passes Job 3 and at least one of Jobs 1 and 2. For most small sites that leaves Organization, Article and Product — an afternoon of work — and frees the rest of the week for the visible content AI engines actually quote.

Free to use and adapt. If you cite it, link to rankbox.xyz/glossary/schema-markup.

What does schema markup still get you in Google?#

Schema markup still makes pages eligible for Google rich results — product prices and ratings, review stars, recipes, events, videos and job postings — which can lift clicks on classic listings, but several once-popular types no longer show, including FAQ rich results since May 2026.

TypeStatus in Google Search, September 2026Worth adding for
OrganizationSupported — logo, legal name and identifiers can appear in knowledge panelsEvery site, on the homepage
Article / BlogPostingSupported — helps Google show the right title, image and datesEvery blog post
Product, SoftwareApplicationSupported — price, availability, ratingsWhat you sell
LocalBusinessSupported — address, hours, contact detailsBusinesses serving an area
FAQPageNo longer shown since 7 May 2026Nothing in Google
HowToDeprecated in September 2023Nothing in Google
Claim Review, Course Info, Estimated Salary and four othersPhased out from June 2025Nothing in Google

Google’s own case studies report click-through gains from rich results — Rotten Tomatoes measured a 25% higher click-through rate on marked-up pages — though those figures come from the sites themselves. Treat rich results as a way to stand out in classic listings on the SERP, not as a route into AI answers.

Which schema markup types matter most for a small business site?#

Most small business sites need only four schema types: Organization on the homepage, Article or BlogPosting on posts, Product or SoftwareApplication on what you sell, and LocalBusiness if you serve an area. Everything else can wait until Google documents a rich result you actually want.

  • Organization — name, URL, logo and sameAs links to your LinkedIn, YouTube, Crunchbase or Wikipedia pages. It’s the cheapest entity SEO signal you control, and it helps systems like Google’s Knowledge Graph tell your brand from a similarly named one.
  • Article / BlogPosting — headline, an author linked to a real author page, datePublished and an honest dateModified. AI engines weigh dates — Perplexity stores publish and update dates per page, and Claude sees each result’s age — so keep the markup, the visible date and your sitemap’s lastmod in agreement.
  • Product or SoftwareApplication — price, currency, availability and genuine ratings, identical to what the page shows.
  • LocalBusiness — address, hours and phone number, consistent with your Google Business Profile.

Common mistakes with schema markup#

The most common schema markup mistakes are marking up facts the page doesn’t show, letting prices and dates drift out of sync with the copy, injecting JSON-LD with JavaScript that AI crawlers never run, and treating markup as a substitute for clear visible content.

Myth

FAQ schema is the shortcut into AI answers.

Reality

FAQ rich results stopped showing in Google on 7 May 2026, and SE Ranking found pages with FAQ schema averaged fewer ChatGPT citations than pages without. Write the questions as visible headings with answer-first text instead.

Myth

Markup can describe things the page doesn't show.

Reality

Google’s guidelines say not to mark up information that isn’t visible, and its AI features guide asks that structured data match the visible text. Mismatches undermine trust in both.

Myth

JSON-LD from a tag manager works everywhere.

Reality

Google can read JSON-LD injected by JavaScript. Crawlers that don’t run scripts — OpenAI’s, Anthropic’s, Perplexity’s — can’t. Put it in the HTML; see server-side rendering.

Myth

More types and properties are always better.

Reality

Google says it’s more important to supply fewer, complete and accurate properties than every possible one. Markup nobody maintains drifts out of date.

Sources

  1. 1.Introduction to structured data markup in Google SearchGoogle Search Central · developers.google.com
  2. 2.Optimizing your website for generative AI featuresGoogle Search Central · developers.google.com
  3. 3.Latest documentation updates (FAQ rich result deprecation)Google Search Central · developers.google.com
  4. 4.Changes to HowTo and FAQ rich resultsGoogle Search Central Blog · developers.google.com
  5. 5.Schema.orgSchema.org · schema.org
  6. 6.We tracked 1,885 pages adding schema. AI citations barely moved.Ahrefs · ahrefs.com
  7. 7.How to optimize for ChatGPTSE Ranking · seranking.com
  8. 8.Schema helps Microsoft's LLMs (Copilot) understand your contentSearch Engine Roundtable · seroundtable.com

Know someone who’d find this useful? Send it their way.

Written by

Rankbox Team

The team behind Rankbox. We study how ChatGPT, Perplexity, Gemini, and Google AI Overviews choose their sources, and publish what we learn so you can put it to work.

See which AI answers cite you today

Enter your site to see how often ChatGPT, Perplexity, Gemini, and Google cite your brand, and exactly what to publish next.

No credit card required · Free 7-day trial