How to Add Schema Markup in WordPress (2026 Step-by-Step)

To add schema markup in WordPress you have two routes: use an SEO plugin like Rank Math, Yoast SEO, or All in One SEO that generates the code for you, or add JSON-LD manually through your child theme's functions.php file. The plugin method suits almost everyone because it needs no code and adds core schema automatically. The manual method gives full control for custom types. Both should output JSON-LD, the format Google recommends, and both need testing before you trust them.

Key takeaways

• The fastest way to add schema markup in WordPress is a plugin: Rank Math, Yoast SEO, or All in One SEO add it with no code.
• The manual route is JSON-LD in a child theme's functions.php hooked to wp_head, or a snippet in a code-snippets plugin so theme updates do not erase it.
• Google Search Central recommends JSON-LD and calls it the easiest format to maintain, so avoid Microdata and RDFa on new sites.
• Match the schema type to the page: Article for posts, Product for shop items, LocalBusiness for a physical location, HowTo for tutorials, BreadcrumbList for navigation.
• Google removed FAQ rich results from Search in 2026, so schema is now more about helping engines understand your content than about SERP decorations.
• Always validate with the Rich Results Test and the Schema Markup Validator before relying on any markup.

What schema markup is, in plain terms

Schema markup is a shared vocabulary of tags, defined at Schema.org, that you add to a page's code to describe what the content actually is. It tells a search engine that a block of text is a recipe, a product with a price, a business with an address, or an article with an author and a publish date. Search engines and AI systems read that structured data to understand the page more reliably than they could from the raw words alone.

On a WordPress site, schema usually appears as JSON-LD: a small block of structured data inside a script tag in the page's head. You rarely write it by hand once a plugin is running, because the plugin builds it from the content you already enter. The goal is to remove ambiguity so an engine knows a page is, say, a LocalBusiness in Katy, Texas rather than just a page that happens to mention a town.

Why does schema markup matter for SEO and AI search?

Schema markup matters because it makes your content machine-readable, which qualifies pages for rich results and helps AI engines verify and cite what you publish. Google's own documentation shows the payoff: it cites Rotten Tomatoes seeing a 25% higher click-through rate on pages with structured data, Food Network gaining a 35% increase in visits after adding it to most of its pages, and Nestle recording an 82% higher click-through rate on rich-result pages versus standard ones. Those are Google Search Central case studies, not estimates.

The picture for AI search is more nuanced, and this is where a lot of guides are wrong. Ahrefs tracked 1,885 pages that added JSON-LD schema between August 2025 and March 2026 and found no clear lift in AI citations from schema alone. But Ahrefs also reported that 53% of pages cited by AI have schema, roughly three times the rate of pages that are not cited. The honest read: schema helps engines understand and trust your content, but it works alongside strong content and authority rather than replacing them. If you are still building up the basics, our primer on what SEO is sets the context, and our guide on how to make a sitemap covers another piece of the same machine-readable foundation.

The main methods to add schema in WordPress

There are five common ways to get schema onto a WordPress page. Most people only need the first one.

Two things decide your route. If you want the least work and the fewest ways to break the site, use an SEO plugin you probably already have. If you need a schema type no plugin offers, or you like keeping code in your own hands, go manual. The next sections walk both.

How do you add schema markup with a plugin?

The plugin method is the recommended path for most WordPress owners: install an SEO plugin, and it outputs core schema automatically while letting you set a type per post. Rank Math, Yoast SEO, and All in One SEO all do this, and all output JSON-LD. Here is the sequence, using Rank Math as the example because its per-post Schema Generator is the most flexible of the free options.

1. Install an SEO plugin. In your dashboard go to Plugins, then Add New, search for Rank Math (or Yoast SEO or All in One SEO), install, and activate. Run the setup wizard so it knows your site name, logo, and whether you are an organization or a person.
2. Set sitewide defaults. In Rank Math go to Rank Math SEO, then Titles and Meta, then Posts, and choose a default Schema Type such as Article for your blog. This applies to every post unless you override it.
3. Open the post you want to mark up. In the editor, click the Rank Math Schema tab, then Schema Generator. You can also reach it from the three-dot menu in the top right, under the Rank Math panel.
4. Pick the type and fill the fields. Choose Article, Product, Recipe, HowTo, LocalBusiness, or another type, then complete the fields the type requires. The plugin turns your entries into valid JSON-LD.
5. Save and test. Update the post, then run its URL through the Rich Results Test to confirm the markup is valid and eligible.

Yoast SEO works a little differently. It adds Organization, Website, WebPage, and Article schema automatically as one connected graph rather than separate blocks, which is a cleaner approach for entity relationships. To change a specific page, open the Yoast SEO Schema tab in the editor and set the page type and article type. For step-by-step content, drop in Yoast's HowTo structured data block and it adds the matching markup for you. If you are still choosing a platform, our comparison of the best CMS for SEO explains why WordPress handles this so well.

How do you add schema markup manually with JSON-LD?

The manual method means writing JSON-LD yourself and outputting it in the page head, usually through a child theme's functions.php file hooked to wp_head, or through a code-snippets plugin. Google Search Central recommends JSON-LD and describes it as the easiest format for site owners to implement and maintain at scale, and less prone to errors than Microdata or RDFa, which is exactly why the manual route still uses it. Use a child theme or a snippet plugin so a theme update does not wipe your code.

A minimal Article block looks like this. Shown here as plain text so you can copy it, not as live markup:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Your post title",
  "author": { "@type": "Person", "name": "Your Name" },
  "datePublished": "2026-07-02"
}
</script>

To output that from a child theme, add a function to functions.php that echoes the script inside the wp_head hook, ideally with a conditional so it only fires on the right template such as is_single(). That conditional matters: schema that describes the wrong page type is worse than none, because it tells engines something untrue about the content. After saving, load the page, view source to confirm the block is present, and validate it. The manual route pairs well with a solid publishing routine, which our walkthrough on how to publish on WordPress lays out end to end.

Common schema types and when to use each

Choosing the right type is most of the job. Schema.org lists hundreds of types, but a normal WordPress site uses a handful. Match the type to what the page genuinely is, never to what you wish it ranked for.

One important update: Google announced on May 7, 2026 that FAQ rich results will no longer appear in Google Search, and support was removed from the Rich Results Test by June 2026. FAQPage markup still helps engines parse your Q and A content, and this page uses it, but do not add it expecting the old expandable snippet. That change is a good reminder to mark up pages honestly rather than chasing decorations.

How do you test schema markup after adding it?

Test every page you mark up before you trust it, using two free tools. Google's Rich Results Test tells you whether a page qualifies for a rich result and flags errors in the types Google supports. The Schema Markup Validator at validator.schema.org checks your markup against the wider Schema.org vocabulary, which is useful for types Google does not surface as rich results. Google recommends the Rich Results Test during development and the structured data reports in Search Console for monitoring after launch.

The routine is simple. Paste the live URL or the raw code into the Rich Results Test, read the detected items, and fix any error or missing required property it lists. Then run the same page through the Schema Markup Validator to catch anything outside Google's scope. Once both are clean, check Search Console over the following weeks for structured data issues that only appear once Google recrawls. Skipping this step is the most common reason schema silently fails to do anything.

Which schema plugin should you choose?

Pick based on what you already run and how much you want to automate. If you have no SEO plugin yet, a full SEO plugin that includes schema is the efficient choice because it covers titles, sitemaps, and structured data in one tool. If you already run Yoast or Rank Math and only need heavier schema automation across templates, a dedicated schema plugin adds that without replacing your setup.

Prices above are the vendors' listed figures as reported by AIOSEO and WPBeginner in 2026; check the current pricing pages before you buy, since plans change. Whatever you pick, running two overlapping schema plugins at once is the classic mistake: they duplicate output and confuse validators. Choose one source of truth for schema and disable the rest.

Frequently asked questions

What is the easiest way to add schema markup in WordPress? Install an SEO plugin that generates schema for you, such as Rank Math, Yoast SEO, or All in One SEO. Once active, the plugin adds core schema automatically and lets you pick a type per post. For most site owners this is the fastest, safest route because it needs no code.

Do I need a plugin to add schema markup in WordPress? No. You can add schema manually by placing JSON-LD in your child theme's functions.php and hooking it to wp_head, or by pasting a script into a code-snippets plugin. Google recommends JSON-LD and calls it the easiest format to maintain, so most people still choose a plugin to avoid editing theme files.

Which schema format does Google recommend for WordPress? Google Search Central recommends JSON-LD. Google describes it as the easiest solution for site owners to implement and maintain at scale and less prone to errors than Microdata or RDFa. Every major SEO plugin outputs JSON-LD by default.

How do I add schema markup in Rank Math? Open the post editor, click the Rank Math Schema tab, then Schema Generator. Pick a type such as Article, Product, or FAQ and fill the fields. To set a sitewide default, go to Rank Math SEO, then Titles and Meta, then Posts, and choose a Schema Type there.

How do I add schema markup in Yoast SEO? Yoast SEO adds Organization, Website, WebPage, and Article schema automatically as a connected graph. To change a page's type, open the Yoast SEO Schema tab in the editor and set the page and article type. For HowTo or FAQ content, use the Yoast structured data blocks.

How do I add schema markup manually in WordPress? Write valid JSON-LD, wrap it in a script tag with type application/ld+json, and output it in the page head. The safe way is a function in a child theme's functions.php hooked to wp_head, or a code-snippets plugin so a theme update does not wipe it. Always test the result before relying on it.

What are the most common schema types for a WordPress site? The types most WordPress sites use are Article or BlogPosting for posts, Product and Review for shops, LocalBusiness for a physical location, Organization and WebSite sitewide, HowTo for tutorials, and BreadcrumbList for navigation. Pick the type that matches what the page actually is.

Does FAQ schema still show rich results in Google? No. Google announced on May 7, 2026 that FAQ rich results will no longer appear in Google Search, and support was removed from the Rich Results Test by June 2026. FAQPage schema can still help search and AI engines understand your content, but it no longer produces the expandable FAQ display in results.

How do I test my schema markup after adding it? Run the page through Google's Rich Results Test to check whether it qualifies for a rich result, and use the Schema Markup Validator on validator.schema.org to check the markup against the full Schema.org vocabulary. Fix any errors, then monitor the structured data reports in Search Console.

Will schema markup improve my Google rankings or AI citations? Schema does not directly boost rankings. An Ahrefs study of 1,885 pages that added JSON-LD found no clear lift in AI citations from schema alone, though 53% of AI-cited pages use schema, about three times the rate of pages that are not cited. Schema helps engines understand and qualify your content; strong content and authority still do the ranking.

What to do next

Start with a plugin. Install Rank Math, Yoast SEO, or All in One SEO, set a default Article type for your posts, mark up your key templates, and validate each one in the Rich Results Test. Only reach for manual JSON-LD when you need a type the plugin cannot produce. If you want a second set of eyes on your structured data, or you are not sure which pages deserve schema first, request a free SEO audit from Rankite and we will show you where the technical wins are.