How to Add Schema Markup to WordPress (Complete Guide)

Even well-written content won’t rank if search engines can’t understand it. Schema markup solves this by giving search engines crucial context, helping you earn rich snippets, knowledge panels, and better search visibility.

Schema markup looks like code, which can deter many WordPress users. But you don’t need to write code. Most SEO plugins handle schema automatically, and dedicated schema plugins simplify it even further.

This guide explains what schema markup does, why it matters, and several easy ways to add it to WordPress, whether you prefer SEO plugins, schema tools, or manual methods.

What Is Schema Markup WordPress?

Schema markup is structured data you add to your website’s HTML to help search engines understand the content on each page. Without it, search engines have to guess what your content is about based on titles, headings, and plain text. With it, you can tell them exactly what kind of content a page contains, whether that’s an article, a product, a recipe, a local business, a review, or something else.

The vocabulary for schema markup is derived from Schema.org, a collaborative project backed by Google, Microsoft, Yahoo, and Yandex. Because all major search engines use the same vocabulary, adding schema markup once helps your pages communicate clearly with them all.

There are three schema formats: JSON-LD, Microdata, and RDFa. Google recommends JSON-LD, which most WordPress plugins use. JSON-LD appears in the head or body as a code block, separate from visible content. Microdata and RDFa mix markup into existing HTML tags.

You don’t really need to understand the difference in depth. What matters is that JSON-LD is the current standard, and the plugins covered below all produce JSON-LD output.

Why Add Schema Markup to Your WordPress Site?

Schema markup isn’t a ranking factor on its own. Google’s John Mueller has confirmed this multiple times, and he reiterated it again in early 2026. Adding schema won’t directly push you up the rankings.

But, what schema does is make your pages eligible for rich results. These are the enhanced listings you see in Google that include star ratings, product prices, recipe cards, event dates, and more. They stand out from plain text links and usually attract more clicks.

Here are the main reasons to add schema markup to your WordPress site:

• Better product visibility on eCommerce sites through Product schema, which displays prices, ratings, and stock directly in search
• Higher click-through rates because rich snippets take up more space in search results and draw the eye
• Better context for search engines and LLMs, especially for data like prices and availability that can’t be pulled reliably from plain text
• Eligibility for knowledge panels when you add Organization or Person schema
• Local SEO benefits from LocalBusiness schema, which matters for location-based searches
• Clearer connections to your social profiles, which help search engines understand your brand entity

Common Types of Schema Markup

Schema.org defines hundreds of data types, but you’ll only use a handful of them in practice. Here are the most common types for WordPress sites:

• Article schema is used for blog posts, news stories, and any editorial content like headline, author, and publish date
• Product schema is used on eCommerce stores and powers the price-and-star-rating snippets you see in search results
• LocalBusiness schema tells search engines about a physical business including address, phone number, opening hours, and business type, which is essential for restaurants, law firms, dentists, and any other location-based business
• Recipe schema covers prep time, cook time, ingredients, nutrition, and ratings for food content
• Event schema is used for upcoming events, concerts, workshops, or conferences
• Review schema is used when you’re reviewing a product, book, movie, or service and includes the rating and reviewer
• Organization and Person schema tells search engines about the entity behind your site, with Organization for businesses and Person for individual creators

Other types you might come across include Course schema for online courses, JobPosting schema for job boards, Book schema for book reviews, and VideoObject for video content.

How to Add Schema Markup to WordPress With a Plugin

For most WordPress users, plugins are the easiest way to add schema markup. No coding is needed, and most plugins stay updated with Google’s guidelines.

Here are the main plugin options worth considering.

1. Rank Math

Rank Math is a popular SEO plugin with robust free schema options, supporting over 15 schema types, including Article, Product, Recipe, and LocalBusiness.

To use schema in Rank Math, install the plugin and enable the Schema module. Set default schema in Titles & Meta, and customize per page in the editor’s Schema tab (shown below).

When you open any post or page, the Rank Math panel in the editor has a Schema tab where you can customize the markup for that specific page. The plugin automatically fills in the basics like headline, author, publish date, and featured image from your post, so you usually only need to adjust or add a few fields by hand.

The Pro version adds features like multiple schema types per page, custom schema, and schema import, with pricing starting at around $95 – 110/year.

2. All in One SEO (AIOSEO)

All in One SEO is another popular plugin with an integrated schema generator, supporting about 20 types and focusing on ease of use for beginners.

The free version handles the Knowledge Graph setup, which lets you define whether your site represents a person or an organization and fill in details like name, logo, contact info, and founding date.

Per-content-type and per-post schema control is only available on the paid plans, which start at $49.60 per year for the Basic plan. This is where you can set a default schema type for each content type (like Article for posts and Web Page for pages) and override it on individual posts.

3. Yoast SEO

Yoast SEO is a long-standing plugin that handles schema automatically based on your site’s settings, minimizing manual input.

On setup, Yoast collects organization or person details, logo, and social links to build structured data for your site.

One thing Yoast does better than most other schema plugins is build a full connected schema graph, where each piece of structured data references the others. This is closer to how Google recommends structured data should be implemented, compared to plugins that add schema as separate disconnected blocks.

For WooCommerce, Yoast offers a separate premium add-on to enable product schema.

4. Schema Pro

Schema Pro is a premium dedicated schema plugin from Brainstorm Force, the same team behind the popular Astra WordPress theme. Unlike the options above, Schema Pro doesn’t handle any other SEO tasks. It focuses entirely on structured data.

Schema Pro automates schema by setting rules and mapping them to post types, ideal for large or multiple client sites.

Schema Pro supports over 20 schema types and works alongside any SEO plugin you already have. It’s premium only, with pricing starting around $69 per year.

5. Schema & Structured Data for WP & AMP

If you want a free standalone schema plugin, Schema & Structured Data for WP & AMP is one of the better options on the WordPress repository. It supports over 35 schema types and includes AMP support, which is useful for sites that still run accelerated mobile pages.

Setup takes a bit more work than the SEO plugins above, but you get a lot of control without paying anything. It’s a solid pick if you already have an SEO plugin you like and just want to add more thorough schema on top of it.

Plugin Comparison

Plugin	Free Schema Types	Automatic Schema	Custom Schema	Best For
Rank Math	15+	Yes	Pro only	Most users
All in One SEO	Limited (Lite); 20+ (Pro)	Yes	Pro only	Beginners who want full SEO
Yoast SEO	Basic graph and blocks	Yes	Limited	Simple sites that want set-and-forget
Schema Pro	20+	Yes	Yes	Agencies, large sites
Schema & Structured Data	35+	Yes	Limited	Users who want free with lots of types

How to Add Schema Markup to WordPress Manually

If you prefer not to install another plugin, or you want precise control over a specific page’s schema, you can add it manually. This works well for one-off situations like a custom landing page or a unique content type that your plugin doesn’t handle.

The recommended format is JSON-LD, which is a small block of code you paste into the head or body of your page.

Generating the Code

You can write JSON-LD by hand if you know the Schema.org vocabulary, but most people use a generator. You can use this schema markup generator, which supports all the main types and outputs valid JSON-LD.

All you have to do is pick your schema type from the dropdown, fill in the fields, and copy the generated code.

If you prefer Google’s own tool, the Structured Data Markup Helper still works, though Google has acknowledged it’s outdated and doesn’t reflect all current schema features.

Adding the Code to WordPress

Once you have the JSON-LD, the cleanest way to add it to WordPress is with a dedicated snippet plugin. The free Code Snippets plugin handles this well and is what we usually recommend. It lets you paste your JSON-LD into the plugin and generates a shortcode you can drop into any page or post, without editing theme files.

To use Code Snippets, install and activate the plugin by going to Plugins > Add Plugin in your WordPress dashboard. Once it’s active go to Snippets > Add New, give your snippet a name, select HTML, and paste a small function that adds your featured snippet code.

Save and activate the snippet, and the plugin will generate a shortcode you can copy. Just click the Location shortcode option to view your shortcode. Then, all you have to do is paste that shortcode into the page or post where the schema should load.

You can also edit your theme’s header.php file and paste the JSON-LD before the closing </head> tag, but this isn’t recommended unless you’re working inside a child theme. Theme updates will wipe out any direct changes you’ve made to the file otherwise. Plus, this doesn’t give you page by page control over your schema.

How to Add Schema Markup to a WooCommerce Store

WooCommerce adds basic Product schema to product pages by default, but it’s fairly minimal. If you want the full range of schema fields like aggregate ratings, brand, GTIN numbers, and availability, you’ll want help from a plugin.

Here are the main options for WooCommerce schema:

• Rank Math (free or Pro) adds full Product schema automatically once you enable WooCommerce support. It pulls data from your product fields and formats it correctly for Google’s Merchant listings. Variable products will need the pro version.
• Yoast WooCommerce SEO is a paid add-on for the Yoast SEO plugin. It adds product-specific schema and handles some WooCommerce-specific SEO issues.
• AIOSEO includes WooCommerce schema support in its paid plans, along with sitemap improvements and other store-specific features.

For most WooCommerce stores, Rank Math gives you everything you need without extra cost. The key is to make sure your product pages pass Google’s Merchant listing requirements, which means having Product, Offer, and AggregateRating schema at a minimum.

How to Test Your Schema Markup

After adding schema to your site, you should always test it to make sure it’s valid and Google recognizes it. There are two main tools for this.

Google Rich Results Test

The Rich Results Test is Google’s official tool, and it’s what most SEOs use as the first check.

To use it, head over to the tool and paste the URL of the page you want to test. If your page isn’t live yet, switch to Code mode and paste the JSON-LD directly. Click Test URL and wait for the tool to finish.

The tool tells you which rich result types the page is eligible for and flags any errors or warnings. Errors stop your page from earning rich results and need to be fixed. Warnings are suggestions that can improve your snippet, but won’t block it from showing.

Keep in mind, the Rich Results Test only checks schema types that Google uses for rich results. That’s around 30 types out of the 800+ defined by Schema.org. If you’re using a more obscure schema type, you’ll need the next tool.

Schema Markup Validator

The Schema Markup Validator is run by the schema.org team and checks your markup against the full Schema.org vocabulary. It won’t tell you if you’re eligible for Google rich results, but it will tell you if your syntax is valid and your properties are correct.

The best thing to do is use both tools together. Run your page through the Rich Results Test first to check Google eligibility, then run it through the Schema Markup Validator if you’re using schema types beyond what Google supports.

Common Schema Markup Mistakes to Avoid

Even with a plugin doing most of the work, there are a few mistakes that come up often enough to watch for.

1. Marking Up Content That Isn’t Visible on the Page

Google’s guidelines say your schema needs to describe content that’s actually visible on the page. If you add Product schema with prices and ratings that don’t appear anywhere visible, you’re at risk of a manual action from Google.

Whatever you mark up needs to match what a real visitor sees. The same applies to Review ratings, Event dates, and Recipe ingredients.

2. Using the Wrong Schema Type

Picking the wrong schema type usually happens when site owners pick the type they hope will earn the best rich result rather than the type that fits the content.

A common example is using Article schema on category or product listing pages. Those aren’t articles, and Google will either ignore the markup or flag it. When in doubt, look at what your page actually contains and pick the type that matches.

3. Schema Drift on eCommerce Sites

Schema drift happens when your structured data falls out of sync with what’s on the page. Prices change, stock levels change, and if your schema still says a product is $29.99 and in stock when it’s actually $24.99 and sold out, Google can penalize the site.

The fix is to use a plugin like Rank Math or AIOSEO that pulls product schema directly from your WooCommerce fields, so it updates automatically.

4. Duplicate Schema From Multiple Plugins

If you’re using more than one plugin that adds schema, you can end up with conflicting or duplicate markup on the same page. SEO plugins, schema plugins, themes, and page builders all add their own structured data.

Pick one tool to handle your schema and disable the schema features in everything else. After installing any new plugin, run a few pages through the Rich Results Test to confirm you only have one set of schema per page.

5. Missing Required Properties

Each schema type has required properties, and if you leave any out, Google won’t display rich results even if the rest of the markup is valid.

Recipe schema needs name, image, recipeIngredient, and recipeInstructions at a minimum. Product schema needs name, image, and either offers, review, or aggregateRating. The Rich Results Test will flag missing properties as errors, so test after every schema change.

Schema Markup WordPress FAQs

Final Thoughts on Schema Markup WordPress

Schema markup is one of the easier SEO wins available to WordPress site owners. Most of the work is handled by plugins, and adding it takes a few minutes rather than hours. The payoff is better visibility in search results, higher click-through rates, and eligibility for features like product cards, recipe snippets, star ratings, and event listings.

If you’re starting from scratch and want an all-in-one solution, Rank Math’s free version is the strongest schema toolkit available without paying anything. All in One SEO is a close second if you prefer its interface. Yoast SEO works well if you want a simpler setup and don’t need fine-grained control.

Whichever approach you choose, the important part is to test your markup with Google’s Rich Results Test after setting it up, and again any time you change themes or plugins. Schema markup only works when it’s valid, and small issues can quietly break the rich results you’re trying to earn.

Now over to you. Are you currently using a schema plugin on your WordPress site? Let us know which one works best for you in the comments below.