WordPress Schema Markup: How to Add Structured Data

📋 Table of Contents

• What Is Schema Markup?
• Schema vs. Rich Results
• How to Choose the Right Schema Type
• Add Schema with Yoast SEO
• Add Schema with Rank Math
• Add Custom JSON-LD Schema
• Useful Schema Examples
• Validate and Test Schema Markup
• Common Schema Mistakes
• FAQ

Simple Example

A WordPress SEO blog post can include structured data that identifies:

• The page as an article
• The article headline
• The author
• The publication date
• The featured image

⚠️ Important Reality Check

Valid schema makes a page eligible for a rich result. It does not guarantee that Google will display one, and structured data is not a generic ranking factor. Focus on adding accurate schema that reflects real page content.

✅ Common Schema Types for WordPress

• Article or BlogPosting: For blog posts and editorial articles
• FAQPage: For pages that present genuine questions and answers
• HowTo: For step-by-step instructional content, where eligible
• Product: For individual product pages
• Review: For genuine review content
• Organization: For information about an organization
• WebSite: For site-level information
• BreadcrumbList: For breadcrumb navigation
• LocalBusiness: For businesses with a physical or service-area presence

⚠️ Use FAQ Schema Carefully

FAQ schema is intended for pages that provide official questions and answers. Do not add it to forum threads, comment sections, or pages where visitors can submit answers. Also note that Google announced in 2023 that FAQ rich results would be shown only for well-known, authoritative government and health websites.

✅ Basic Yoast Setup

1. Install and activate Yoast SEO.
2. Go to Yoast SEO → Settings.
3. Open the relevant site or content settings.
4. Check that schema-related features are enabled.
5. Set your organization or person details where Yoast asks for them.
6. Open a post and review the Yoast schema settings.
7. Choose the most accurate page or article type available.
8. Update the post and test it with Google’s Rich Results Test.

For a standard blog post, Yoast commonly outputs article-related structured data automatically. Make sure the post has a clear title, author, publication date, and featured image where appropriate.

In the Yoast settings for the post, select the most accurate article type available. Avoid selecting a specialized schema type unless the page genuinely represents that content type.

After saving, test the live URL in the Rich Results Test to confirm that Google can read the structured data.

✅ Basic Rank Math Setup

1. Install and activate Rank Math SEO.
2. Go to Rank Math SEO → Dashboard.
3. Open the schema or structured-data settings.
4. Enable schema where available.
5. Set default schema for posts and pages.
6. Open an individual post or page.
7. Use the schema tab or schema generator to choose the appropriate type.
8. Complete only the fields that accurately describe the page.
9. Save, update the page, and test it with the Rich Results Test.

If your page includes a visible FAQ section, add FAQ schema only for questions and answers that appear on that page.

For example, a page about WordPress permalinks can include questions such as “What is a permalink?” and “How do I change permalinks in WordPress?”—but only if those questions and answers are visible to users.

Do not add FAQ schema to a page that does not contain a real FAQ section.

✅ Safe Custom JSON-LD Workflow

1. Back up your site.
2. Use a child theme or a trusted code snippets plugin.
3. Create the JSON-LD for the specific page.
4. Add the code only where it applies.
5. Test the code with Google’s Rich Results Test.
6. Check the live page after deployment.
7. Monitor Search Console for structured-data issues.

This is a simplified example. Replace every placeholder with accurate information from the page, and do not add this code if your SEO plugin already outputs equivalent article schema.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "WordPress Schema Markup: How to Add Structured Data",
  "description": "Learn how to add schema markup in WordPress using JSON-LD, Yoast SEO, or Rank Math.",
  "author": {
    "@type": "Person",
    "name": "Your Author Name",
    "url": "https://yourdomain.com/author/your-author/"
  },
  "datePublished": "2026-10-13",
  "dateModified": "2026-10-13",
  "image": "https://yourdomain.com/wp-content/uploads/2026/10/schema-markup.png",
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://yourdomain.com/wordpress-schema-markup/"
  }
}
</script>

Use only properties that are accurate for your page. Google’s Article documentation advises adding properties that apply to the content and validating the implementation with the Rich Results Test.

Never assume schema is working just because the plugin says it is enabled. Test the live page after publishing or updating it.

✅ Testing Checklist

• Use Google’s Rich Results Test to check for Google-specific rich-result eligibility.
• Use the Schema Markup Validator for broader Schema.org validation.
• Use Search Console’s URL Inspection tool to check how Google sees the indexed version.
• Check Search Console’s rich-result reports after deployment.
• Fix critical errors before adding more schema.

Do not add Product schema to a blog post or FAQ schema to a page without visible questions and answers. Schema should describe the page’s actual content.

Do not add structured data for content that users cannot see on the page. Google’s guidelines require markup to be representative of the main content and visible to users.

Avoid running two SEO plugins or schema plugins that output duplicate structured data for the same page. Choose one primary solution and test the result.

Schema can make a page eligible for enhanced search features, but it does not guarantee rich results or improved rankings.

Replace every placeholder, URL, date, author name, and image URL with accurate information from the actual page.

Frequently Asked Questions

Q: What is the best schema format for WordPress?

A: JSON-LD is generally the easiest and Google-recommended format. It is added as a script and does not require wrapping every visible HTML element in markup.

Q: Does schema markup improve Google rankings?

A: Structured data itself is not a generic ranking factor. It helps Google understand content and can make a page eligible for rich results, but it does not guarantee rankings.

Q: Can I add FAQ schema to every blog post?

A: No. Add FAQ schema only when the page contains genuine, visible questions and answers. Also note that FAQ rich results are no longer regularly shown for most sites.

Q: Which is better: Yoast or Rank Math for schema?

A: Both can generate useful WordPress schema. Choose the one you already use and configure it correctly. Avoid running both plugins’ schema output for the same page at the same time.

Q: How do I check whether schema is working?

A: Use Google’s Rich Results Test, the Schema Markup Validator, and Search Console’s URL Inspection tool. Then monitor Search Console’s rich-result reports after deployment.

• Choose schema that matches the visible page content
• Use JSON-LD where possible
• Use one primary schema solution to avoid duplicates
• Add only accurate properties and values
• Do not mark up invisible or misleading content
• Test with the Rich Results Test before publishing
• Check the live page after deployment
• Monitor Search Console for structured-data issues
• Update schema when the page content changes

🚀 Related Technical SEO Resources