Dev.to WebDev 🛠 Dev Mon, 21 Sep 2026 21:33:31 +0000 👁 0 📖 3 min read

JSON-LD Structured Data: The Developer's Lever for SEO and AI Citations

Most SEO advice lands on marketers: write better copy, earn links, fix titles. But there's one high-leverage lever that lives entirely in the codebase, and developers own it outright: structured data. Structured data (u

Structured data (usually JSON-LD) is a small block of machine-readable JSON that tells search engines and AI answer engines exactly what an entity is, instead of making them infer it from prose. It's low effort, it's shippable in an afternoon, and it's increasingly how you get pulled into rich results and cited by AI. Here's the practical version.

What it actually is

JSON-LD is a <script type="application/ld+json"> block you drop in the <head> (or anywhere in the body). It follows the schema.org vocabulary. Nothing renders; it's purely a description for machines.

The minimum viable win for most businesses is an Organization (or LocalBusiness) block:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Acme Plumbing",
  "url": "https://acmeplumbing.com",
  "logo": "https://acmeplumbing.com/logo.png",
  "telephone": "+1-555-123-4567",
  "sameAs": [
    "https://www.linkedin.com/company/acme-plumbing",
    "https://www.g2.com/products/acme-plumbing"
  ]
}
</script>

That sameAs array matters more than it looks: it's how you connect your site to your other verified profiles, which helps engines resolve you as one trusted entity.

Why it matters more now

Two reasons. First, the classic one: rich results. Marked-up reviews, FAQs, breadcrumbs, and products can render enhanced listings that earn more clicks.

Second, the newer one: AI answer engines (ChatGPT, Google's AI Overviews, Perplexity) lean on clearly structured, trustworthy sources when they decide who to cite. Prose forces them to guess; JSON-LD hands them the facts in a format they don't have to interpret. If you want to be quotable by a model, being parseable is step one.

The three blocks worth shipping first

1. Article - on every blog/content page:

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "How to Winterize Your Pipes",
  "author": { "@type": "Organization", "name": "Acme Plumbing" },
  "datePublished": "2026-09-21",
  "image": "https://acmeplumbing.com/winterize.jpg"
}

2. BreadcrumbList - gives engines your site hierarchy and can render breadcrumb rich results:

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://acmeplumbing.com" },
    { "@type": "ListItem", "position": 2, "name": "Guides", "item": "https://acmeplumbing.com/guides" }
  ]
}

3. FAQPage - arguably the highest-ROI for AI citations, because it maps your content to explicit question/answer pairs:

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [{
    "@type": "Question",
    "name": "How much does emergency plumbing cost?",
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "Emergency call-outs typically run $150-$450 depending on the job and time of day."
    }
  }]
}

The gotchas that get people penalized

Mark up what's visible. The structured data must match the content a user actually sees on the page. FAQPage markup for questions that aren't on the page is a spam signal, not a shortcut.
Validate before you ship. Run every template through Google's Rich Results Test and the schema.org validator. A single malformed block can invalidate the whole thing.
One entity, consistent everywhere. Your name, URL, and phone in JSON-LD should match your site, your profiles, and your directory listings exactly. Conflicting data erodes the trust you're trying to build.
Generate it, don't hand-maintain it. In a component-based stack, render the JSON-LD from the same data source as the visible content so they never drift.

Why this is worth an afternoon

Structured data is one of the rare SEO tasks that is fully in a developer's control, ships once, and compounds: better rich-result eligibility and better odds of being cited by AI, from the same block of code. It won't rank a bad site, but on a decent site it's free leverage most competitors skip.

If you want the strategy layer that decides which pages and entities to prioritize on top of the technical implementation, that's what modern AI-native SEO is built to handle. But the JSON-LD itself? Ship it this week. Start with Organization and FAQPage.

Written by the team at Level Up Digital Marketing Group, an AI-native marketing agency helping established service businesses grow through SEO, ads, websites, and smarter use of AI. More at levelupdigitalmarketinggroup.com.

📰 Read the original article on Dev.to WebDev

Originally published by Dev.to WebDev. Aggregated on AIWithGhost for educational purposes — full credit and traffic to the original publisher.

← News 🛠 Dev 🏠 Home