How to Add Schema Markup to WordPress

In this guide: How to add schema markup to WordPress: what structured data is, common schema types, adding schema with plugins or manually, and testing with Google’s tools.

Search results today are more than blue links. You see star ratings, FAQs, breadcrumbs, product prices, event dates, and recipe details. Much of this comes from schema markup — structured data that helps search engines understand your content.

What schema markup is

Schema markup is code (usually in JSON-LD format) that describes the meaning of your content using the shared vocabulary from Schema.org.

For example, instead of search engines guessing that “4.8” on your page is a rating, schema explicitly says: this product has an aggregate rating of 4.8 from 120 reviews.

Benefits:

• Rich results: enhanced search listings that can increase click-through rates.
• Better understanding of your content, entities, and relationships.
• Eligibility for special search features.

Important: schema doesn’t guarantee rich results, and it’s not a direct ranking boost. It makes your content eligible and easier to understand. Google also changes which rich results it shows over time — for example, it has limited FAQ and HowTo rich results for most sites in recent years — so focus on schema that fits your content accurately.

Types of schema

Common types for websites:

• Organization / LocalBusiness: name, logo, contact details, address, opening hours.
• WebSite: site name and search features.
• Article / BlogPosting: headline, author, dates, images.
• BreadcrumbList: navigation path shown in search results.
• Product: price, availability, reviews (for stores).
• Review / AggregateRating: ratings for products and services (must follow Google’s guidelines).
• FAQPage: questions and answers.
• HowTo: step-by-step instructions.
• Event: dates, locations, tickets.
• Recipe, Course, JobPosting, SoftwareApplication, VideoObject, and many more.
• Person: for author pages and personal brands.

Adding schema with plugins

The easiest method for most WordPress users.

SEO plugins

• Yoast SEO, Rank Math, and All in One SEO add foundational schema automatically: Organization/Person, WebSite, Article, and Breadcrumbs.
• Rank Math and AIOSEO include schema builders for additional types in their free or paid versions.
• Configure your site representation (organization or person), logo, and social profiles in the plugin settings.

WooCommerce

• Adds basic Product schema; SEO plugins can enhance it.

Dedicated schema plugins

• Plugins like Schema Pro or WP Schema offer advanced, rule-based schema across many post types.

Block-based FAQs and HowTos

• Some SEO plugins provide FAQ and HowTo blocks that output schema automatically.

Avoid duplicates: if your theme, SEO plugin, and a schema plugin all output Article or Product schema, you may create conflicting data. Use one primary source.

Adding schema manually

For custom needs, you can add JSON-LD directly — for example, via a code snippets plugin or your child theme.

Example LocalBusiness schema:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "Example Web Studio",
  "url": "https://example.com",
  "logo": "https://example.com/logo.png",
  "telephone": "+966-5X-XXX-XXXX",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "King Fahd Road",
    "addressLocality": "Riyadh",
    "addressCountry": "SA"
  },
  "openingHours": "Su-Th 09:00-18:00"
}
</script>

Rules for manual schema:

• Only mark up content visible on the page. Don’t add reviews or FAQs that users can’t see.
• Keep it accurate and updated.
• Follow Google’s structured data guidelines — misleading markup can lead to manual actions.

Testing and validating

1. Rich Results Test (Google): enter a URL or code to see which rich results your page is eligible for and any errors.
2. Schema Markup Validator (Schema.org): checks general schema validity beyond Google’s features.
3. Google Search Console → Enhancements: reports for detected structured data types (like Breadcrumbs, Products, Reviews), including errors and warnings across your site.
4. Monitor results in Search Console’s Performance report — filter by search appearance where available.

Fix errors (required fields missing) first; warnings are optional improvements.

Further reading: official WordPress documentation

Key Takeaways: Schema Markup

• Schema markup describes your content to search engines using JSON-LD.
• Use SEO plugins for foundational schema and add types that match your content.
• Only mark up visible, accurate content, and avoid duplicate schema.
• Test with the Rich Results Test and monitor Search Console.