How to Add Schema Markup in WordPress (Beginner's Guide)

When you search for a recipe and see photos, ratings, and cook times directly in the search results — before clicking anything — that’s structured data at work. When you search for a local business and a knowledge panel appears with hours, address, and reviews, that’s also structured data. These enhanced search results are called rich results, and they’re driven by schema markup embedded in the page’s HTML.

Adding schema markup to your WordPress site doesn’t require coding skills. Most of the work can be done through an SEO plugin. But understanding what schema is, which types matter for your site, and how to validate it correctly will help you avoid common mistakes and get the most out of the effort.

What Is Schema Markup?

Schema markup is code — usually written in a format called JSON-LD — that you add to your web pages to communicate their content in a structured way that search engines can reliably parse. Instead of Google having to infer that a page is about a recipe, schema markup explicitly tells it: “This page contains a recipe, it takes 30 minutes, it has 4.8 stars from 120 reviews, and these are the ingredients.”

Schema markup uses a standardized vocabulary defined at Schema.org, which is maintained collaboratively by Google, Microsoft, Yahoo, and Yandex. Google uses a subset of Schema.org types to power its rich results features; not every schema type produces a visible enhancement in search results, but many do.

Rich results that schema markup can enable include:

• Star ratings on reviews and products
• FAQ dropdowns that expand directly in search results
• Breadcrumb trails below the page title
• Recipe cards with images, ratings, and cook times
• Event listings with dates and locations
• Product prices and availability
• Article bylines and publication dates

Beyond rich results, structured data helps Google understand the relationships between entities on your site — your organization, your authors, your topics — which contributes to how your content is represented in knowledge graphs and AI-generated search features.

Common Schema Types for WordPress Sites

Not all schema types are equally useful for every WordPress site. Here are the most commonly implemented and their use cases:

Article and BlogPosting

The Article and BlogPosting schema types communicate that a page is a piece of editorial content. They include properties like headline, author, datePublished, dateModified, and image. Most SEO plugins add this automatically to WordPress posts.

Google uses article markup partly to validate authorship and publication dates — useful for news and timely content.

FAQPage

FAQPage schema was one of the most impactful rich result types when it was widely activated: pages with it would show expandable questions directly in the search results, sometimes taking up significant SERP real estate. Google has reduced the prominence of FAQ rich results since 2023, but the markup still communicates content structure and is worth adding to pages with genuine FAQ sections.

BreadcrumbList

Breadcrumb schema tells Google the navigational hierarchy of a page — for example, that /blog/category/seo/technical-seo-wordpress/ sits under Home > Blog > SEO. Google typically shows these breadcrumbs in the search result snippet instead of (or alongside) the full URL, which can improve click-through rates.

Product

Product schema is the most feature-rich type for e-commerce sites. It includes price, currency, availability, SKU, reviews, and aggregate ratings. For WooCommerce sites, dedicated plugins or WooCommerce-focused SEO plugin features handle this automatically.

LocalBusiness

If your site represents a business that serves local customers, LocalBusiness (or a more specific subtype like Restaurant, MedicalBusiness, or LegalService) communicates your address, phone number, hours, and service area. This is distinct from your Google Business Profile but complementary to it.

WebSite and Organization

WebSite schema on your homepage enables the Sitelinks Searchbox in Google results (when Google decides to show it) and establishes your site’s identity. Organization schema communicates your brand name, logo, social profiles, and contact information — useful for entity establishment in Google’s knowledge graph.

How to Add Schema Markup via an SEO Plugin

For most WordPress sites, adding schema markup through an SEO plugin is the right approach. Plugins handle the JSON-LD generation automatically, keep markup consistent across pages, and update when your content changes.

Yoast SEO

Yoast SEO adds schema markup automatically for all posts and pages. By default it adds:

• WebSite schema on the homepage
• Organization or Person schema (configurable in Yoast’s Site Representation settings)
• BlogPosting or Article schema on posts
• WebPage schema on pages
• BreadcrumbList schema site-wide (if breadcrumbs are enabled)

Yoast builds these as a “schema graph” — a JSON-LD block where entities link to each other — rather than isolated schema blocks. This is technically sophisticated and helps Google understand relationships between your content.

Rank Math

Rank Math includes a more extensive free schema builder. In addition to Yoast’s automatic types, the free version lets you add FAQ, HowTo, Article, Book, Course, Event, Job Posting, Movie, Music, Person, Product, Recipe, Restaurant, Review, Service, Software Application, and Video schema — all configurable per post through a dedicated schema tab in the editor.

Rank Math’s Schema Generator also includes a custom schema type option and the ability to use schema templates across multiple posts.

All in One SEO and SEOPress

Both AIOSEO and SEOPress include schema builders in their free and Pro tiers with overlapping coverage. If you’re already using one of these plugins, check their schema documentation before installing a separate schema plugin.

Adding Schema Manually with JSON-LD

If you need a schema type not covered by your SEO plugin, or if you want precise control over specific properties, you can add JSON-LD markup manually. JSON-LD is Google’s preferred format because it doesn’t require modifying HTML structure — it’s added as a <script> block.

A simple FAQPage JSON-LD block looks like this:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is schema markup?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Schema markup is structured data added to web pages that helps search engines understand content."
      }
    }
  ]
}
</script>

In WordPress, you can add this to specific pages using a plugin like Code Snippets (to add it programmatically to posts matching certain conditions) or directly in a page’s Custom HTML block in the block editor.

For developers, the cleanest approach is adding schema via a WordPress hook in your theme’s functions.php or a custom plugin, outputting JSON-LD in the <head> using wp_head.

Testing Your Schema Markup

Always test schema markup after adding it. Errors in your markup can prevent rich results from appearing, and some mistakes (like invalid property values) can result in a manual action from Google.

Two primary testing tools:

1. Rich Results Test: Google’s official tool. Paste a URL or code snippet to see which rich result types the markup qualifies for and any errors or warnings. Use this to confirm eligibility for specific rich result features.

2. Schema Markup Validator: The Schema.org validator checks your markup against the full Schema.org vocabulary. It’s more permissive than the Rich Results Test and useful for catching structural errors in custom schema.

Common issues to check for:

• Missing required properties (each rich result type has mandatory fields — Google documents these at developers.google.com/search)
• Incorrect property values (e.g., using a plain number for ratingValue when a string is expected)
• Markup that doesn’t match the visible page content — Google’s guidelines require that structured data accurately represents what users see

After adding or updating schema, monitor the Enhancements section of Google Search Console for your schema types. GSC will show which pages have valid markup, which have warnings, and which have errors.

What Schema Markup Won’t Do

A few realistic expectations:

• Schema doesn’t directly improve rankings. Rich results can improve click-through rate, which indirectly affects traffic and potentially rankings, but there’s no direct ranking boost from having schema.
• Having schema doesn’t guarantee rich results. Google decides whether to show rich results based on its own quality criteria. A page with perfect schema won’t necessarily show star ratings if Google doesn’t find the page authoritative enough or the content suitable.
• You can’t add fake reviews. Schema that misrepresents content — inflated ratings, fake reviews, structured data that doesn’t match the page — violates Google’s guidelines and can result in a manual penalty.

Schema Markup and the Bigger Technical SEO Picture

Schema markup is one layer of technical SEO. It communicates what your content is about, but it only matters if your pages are crawlable, indexed, and technically sound. Before investing heavily in schema, make sure your site’s foundation is solid. Our WordPress SEO guide covers the full technical and content SEO picture, and our technical SEO guide for WordPress goes deep on crawlability, sitemaps, HTTPS, and site structure.

For further reading, Google’s structured data documentation is the authoritative source for which schema types support rich results and what properties are required. Schema.org lists the full vocabulary for all available types.

Conclusion

Schema markup is a practical SEO investment for most WordPress sites. The easiest path is letting your SEO plugin handle it automatically — Rank Math’s free tier covers the widest range of schema types without requiring any coding. For types your plugin doesn’t support, JSON-LD added via a code snippet or custom plugin handles the gaps.

Always validate with the Rich Results Test after changes, monitor Search Console’s Enhancements report, and make sure your structured data accurately reflects your page content. With those habits in place, schema markup becomes a low-maintenance part of your site’s technical SEO foundation.