Fix guide · WordPress

How to Add JSON-LD Schema to WordPress (2026)

JSON-LD schema markup tells search engines (and AI answer engines) what your content is: an article, a product, a FAQ, an organization. Google uses it to generate rich results like FAQ accordions, review stars and article carousels. AI systems like ChatGPT and Perplexity also parse schema markup to surface accurate information about your site. WordPress doesn't add schema by default — this guide shows you how to add it.

Run a free check to confirm this is affecting your site

Why it matters

What this issue costs you

Pages with valid schema markup are eligible for rich results in Google Search, which increases click-through rates by 20–30% on average. For AI visibility, Organization and WebSite schema on the homepage signals brand identity to LLMs that crawl your site. FAQ schema can power direct answer panels for question-based queries.

Step-by-step

How to fix: Missing or invalid JSON-LD schema

WordPress

1
Option A: Yoast SEO (automatic schema graph)
Yoast SEO automatically generates a schema graph for every page — including WebPage, BreadcrumbList and Article or WebPage types depending on the template. For the homepage, set up Organization schema at Yoast SEO → Search Appearance → Company or Person. Add FAQ schema by using the Yoast FAQ block in the block editor.
2
Option B: Rank Math (automatic + per-block schema)
Rank Math outputs schema automatically and lets you add per-post schema via the Schema Generator (Rank Math → Schema → Schema Generator). It supports Article, FAQ, HowTo, Product, Recipe, Event and more. For global Organization schema, go to Rank Math → Titles & Meta → Local SEO.

Option C: Manual JSON-LD in a Custom HTML block

For a quick one-off schema addition, add a Custom HTML block (block editor) or use the "Text" tab (Classic Editor) and paste a JSON-LD script block directly. This Organization schema is a good starting point for homepages:

Custom HTML block / wp_head

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Your Site Name",
  "url": "https://yoursite.com",
  "logo": "https://yoursite.com/logo.png",
  "sameAs": [
    "https://twitter.com/yourhandle",
    "https://www.linkedin.com/company/yourcompany"
  ]
}
</script>

Option D: Add schema via wp_head (theme/plugin)

To add site-wide schema (e.g. Organization on every page) via functions.php:

functions.php

add_action( 'wp_head', function() {
  $schema = [
    '@context' => 'https://schema.org',
    '@type'    => 'Organization',
    'name'     => get_bloginfo( 'name' ),
    'url'      => home_url( '/' ),
  ];
  echo '<script type="application/ld+json">'
       . wp_json_encode( $schema )
       . '</script>' . PHP_EOL;
} );

5
Validate your schema
After adding schema, test with Google's Rich Results Test (search.google.com/test/rich-results) or Schema.org Validator (validator.schema.org). Fix any errors before submitting to GSC.

Verify the fix

Run the checker to confirm the issue is resolved

After applying the steps above, paste your URL below. Our checker will re-run every applicable check and show whether missing or invalid json-ld schema still shows as a failing check.

FAQ

Common questions about missing or invalid json-ld schema

Which schema types matter most for WordPress sites?

Organization (homepage), Article or BlogPosting (posts), BreadcrumbList (navigation), FAQPage (Q&A content), HowTo (tutorial posts), and Product (if you sell anything). Start with Organization and Article — these are the highest-impact for most WordPress sites.

Does schema markup improve my Google rankings directly?

Not directly — schema doesn't change ranking position. But eligible schema can trigger rich results (FAQ panels, article carousels), which increase click-through rates significantly. For AI visibility, schema helps LLMs extract accurate information about your brand.

Yoast already adds schema. Do I need to add more?

Yoast covers the basics well. You may want to supplement with FAQPage blocks (Yoast has a block for this), HowTo blocks for tutorial posts, or Local Business schema if Yoast's local SEO free tier doesn't cover your needs.

While you're here

Related fix guides for WordPress

Missing canonical tagWordPress→Missing Open Graph tagsWordPress→Missing robots.txtWordPress→

Need a full audit?

This checker spots individual issues instantly. deepseoanalysis.com crawls your whole site and tracks changes weekly, from $24/mo.

Deep audit →

See all WordPress fix guides, or run a free check now.