Search and AI Schema markup, and what it actually buys you

Schema markup is a block of JSON-LD in a script tag that tells a machine what your page is. It has never been a ranking factor. Nobody should sell it to you as one. What it buys is eligibility and legibility: a page can show hours and a rating in a result, and an AI model can resolve your entity instead of guessing at it. Here are the two blocks worth writing, and how to tell if they worked.

What it actually buys

Eligibility and legibility, not position. Correct LocalBusiness markup lets a result show your hours and rating, while correct Organization markup lets a model resolve five loose references into one entity. Neither moves you up the page on its own, and any agency selling markup as a ranking lever is selling something it can't deliver.

The failure nobody warns you about

It's almost never a missing tag. More often a plugin writes an Organization block while your theme writes a second one with a different name and logo, and Google resolves that by trusting neither. Nothing in Search Console announces it. The second failure is marking up content nobody can see, like review stars in the code with no reviews on the page.

Two types stopped paying

In August 2023 Google cut FAQ rich results back to government and health sites and retired HowTo entirely. The markup is still legal and still parses. It just produces no result in Google, so write it if you want machines to read the structure, and don't write it expecting a rich result.

Write JSON-LD, in the head

There are three ways to write structured data. Only one is worth using. Google recommends JSON-LD over the two older formats, Microdata and RDFa. It's also the only one that lives in a single block instead of scattered through your markup.

It goes in a script tag with type set to application/ld+json, in the head. That's it.

Start with Organization on the homepage

You need the legal name, url, logo, telephone, postal address, and the profile links, and the field people skip is @id, which matters most, because it's the identifier every other node on the site points back to. Skip it and nothing connects.

Add sameAs pointing at your LinkedIn company page, your Wikidata item, and anywhere else your name is already published, because that's what collapses five loose references into one entity a model can resolve.

One LocalBusiness per location page

Each location page gets its own block, and parentOrganization carries the @id from the homepage Organization, so the two are tied together instead of floating separately.

Pick the narrowest subtype that is true. Dentist, Restaurant, MedicalBusiness, LegalService, HomeAndConstructionBusiness. Most trades have one. What goes on the page around that markup is a different job, and you'll find it in the local search work.

Match the rest of the types to what you sell

Article on posts. Product with offers, price and availability if you have a store. Service on service pages. Person for a founder or author with a public profile. BreadcrumbList goes site-wide on every page below the homepage, and that's the list.

A WebSite node carrying a SearchAction makes a site eligible for the sitelinks search box on its own brand result.

Review and AggregateRating only where the ratings come from somewhere other than your own testimonials page. A rating you awarded yourself is the schema spam pattern that triggers a manual action. Speakable is news-publisher only. Most sites skip it.

Validate twice, against the live URL

Google's Rich Results Test tells you which features the page qualifies for. The Schema.org validator tells you whether the syntax is legal. They answer different questions. You want both answers.

Test the live URL, never the pasted code. Search Console's URL Inspection tool shows the rendered HTML Google actually received, and that's frequently not what your CMS thinks it published.

Measuring schema markup impact

Schema gets your pages eligible for AI citation, but eligibility and actual citation are two different problems, and AirOps is built for the second one. Its Insights layer tracks which URLs ChatGPT, Perplexity, and Google AI Overviews are pulling from for the topics you care about, so you can see citation rate, mention rate, sentiment, and which competitors are being cited in your place.

From there it ties those signals back to your Search Console and analytics numbers, and it can queue the writing needed to fill the gaps it finds, which closes the loop. The loop is the point. A validated schema deployment stops being a hopeful bet and becomes something you can check afterward.

Google Search Console and manual spot-checks

You can also measure a version of this for free. It's slower, it samples instead of measuring, and it won't tell you who got cited in your place, but it costs nothing to run.

Rich result reports. The Enhancements section of Search Console shows rich result impressions and click-through rates over time, so you can compare CTR before and after you deploy.

AI citation spot-checks. Pick fifteen questions a buyer would actually type, run each one in ChatGPT, Perplexity and Google's AI Overview, and record whether you're named and what got cited instead. Re-run the same fifteen monthly. A moving question list turns this into anecdote.

Then go back to it

Markup breaks on plugin upgrades and theme changes. Search Console's Enhancements report is where that surfaces. Recheck two to four weeks after any change, since that's roughly how long the report takes to catch up.

If the page underneath is thin, correct schema describes thin content accurately. That's all it does. Write the answer first. Mark it up second.

Markup ships inside the SEO scope we quote.

Somebody has to write the JSON-LD, validate it against both tools, and read it again after the next theme update. That's a scope line, not a product, so we quote it with the rest of the work instead of selling it on its own.

Have us do it.

See the scope, price, and next steps for the help this guide describes.

See the service

Need help with the wider business?

We continue to help businesses with visibility, reputation, and the places customers find them. See how the services fit together for your business.

See how we help businesses get found

Explore your options

Every guide we publish is free and ungated. Browse all of them, see what we do and what it costs, or read why we built this company.

Written by Drew Chapin, who ran all of this on his own name first.

© The Discoverability Company Privacy Terms