Skip to main content
All guidesScan my site

Add JSON-LD structured data so AI knows what your page is about

JSON-LD tells crawlers what type of content the page is (article, product, FAQ) in machine-readable form.

Worth up to 8 points

Why it matters

AI summaries, knowledge panels, and rich SERP results all draw from JSON-LD. A page tagged as `Article` with a `headline`, `author`, and `datePublished` gets cited differently in ChatGPT answers than a page with no structured data at all.

How to fix it

  1. 1. Pick the right schema type

    Use Organization on your root layout, WebSite on the homepage, Article on blog posts, Product on PDPs, FAQPage on FAQs, BreadcrumbList on deep routes.

  2. 2. Inline it as a script tag in <head>

    JSON-LD is the format Google and OpenAI both recommend over microdata or RDFa.

    <script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "How to fix llms.txt errors",
  "datePublished": "2026-05-01",
  "author": { "@type": "Organization", "name": "Acme" },
  "image": "https://acme.com/cover.png"
}
</script>

  3. 3. Validate

    Paste your URL into validator.schema.org or Google's Rich Results Test. Fix any errors before shipping.

FAQ

Will JSON-LD by itself make me rank?
No, but it materially improves how AI summaries cite you and unlocks rich SERP features (FAQ accordions, breadcrumbs, product cards).

See your own score

Run a free Crawlable scan to find every check that needs fixing on your site — not just this one.

Check my site

More guides