← Fix-it library

Add JSON-LD - with honest expectations

Updated· by

Your page is missing valid JSON-LD with a recognized type - worth fixing, but let’s be honest about what it does first, because schema is the second-most oversold item in AI SEO. LLMs don’t parse structured data as structure: they strip the tags and read whatever text is inside. Treat schema like a meta description - free hygiene, not a strategy.

What does the evidence actually show?

  • The mechanism: an ex-Google search-quality analyst explains that AI systems “download the content, throw away the JavaScript and HTML tags, and keep whatever text is left.” Text inside JSON-LD survives - as text. The structure is discarded. A controlled experiment confirmed it: a fake address placed only in schema was repeated back by ChatGPT and Perplexity, proving they read schema content as raw text.
  • The one real effect: a controlled study found LocalBusiness schema moved nothing on Google, Bing, or Gemini - but lifted ChatGPT position by ~3 spots at high confidence. A follow-up across 1,885 pages found schema correlates with citations mainly because it lives on already-strong sites.
  • The indirect path: schema still powers Google rich results (stars, prices, FAQs) - and since AI systems retrieve through search, anything that helps you in Google helps you in AI answers downstream.

So why add it at all?

Because it’s free, five minutes, and can only help at the margin. A minimal block for a business:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "Rapid Plumbing Co",
  "url": "https://rapidplumbing.example",
  "telephone": "+1-512-555-0100",
  "address": {
    "@type": "PostalAddress",
    "addressLocality": "Austin",
    "addressRegion": "TX"
  }
}
</script>

Declare the type that’s true for the page - LocalBusiness or Organization sitewide, Article on posts, Product on product pages. Most CMS SEO plugins generate this automatically. Validate at validator.schema.org - broken JSON is ignored entirely, which is what this check catches.

What shouldn’t you do?

Don’t buy schema markup as an “AI visibility service,” don’t stack seven layers of nested entities expecting rankings, and walk away from anyone selling schema plus llms.txt as their core deliverable - practitioners flag that pitch as the tell of an AI-SEO grift. Add the honest five-minute version, rescan, and spend your real effort on retrievability and answer-shaped content.

See where your site stands. The free scan takes about fifteen seconds and shows every fix.

Run a free AI visibility scan

Written by

Abdul Jaafar is the founder of AIOScan and runs Mason, a marketing agency focused on search and AI visibility for local businesses. He built AIOScan because most AI visibility scores are made up, and he wanted one that isn't. More on the about page.