Learn

How to add schema markup in WordPress

Schema markup is data in your page that describes what the page is. WordPress has three practical ways to add it. Which one fits depends on the type, and on whether Google still shows a result for that type at all.

By Adem ÇakalPublished 6 sources6 min read
Short answer

Start with what your SEO plugin already prints, since Yoast, Rank Math and AIOSEO all document schema output. Use a dedicated schema tool when you need a type the plugin lacks. Use a hand-written JSON-LD snippet for one-off pages. Whichever route you take, only mark up what is visible on the page, then test the URL with the schema checker.

The three methods compared

MethodGood forWhat the docs sayRisk
SEO plugin graphOrganization, website, page, article, breadcrumb basics on every URLYoast builds a single JSON-LD graph and offers a Schema API to extend it. Rank Math lists over 20 built-in types, with an advanced generator on PRO. AIOSEO has a Schema Catalog opened from the editorPlan limits: several schema controls are PRO or plan-gated
Dedicated schema pluginTypes or templates beyond what the SEO plugin offersNot documented in one place, so read each tool's own docsDuplicate output if two tools print the same type
Manual JSON-LDA single page type, such as a product or event, where you control every valueGoogle's introduction says to use the format you can maintain, and it supports JSON-LDValues drift out of date as the page changes

We have not benchmarked any of these plugins. The table states what the vendors and Google publish, and the cost column is a general maintenance risk, not a measurement.

Which types does Google support today

Google's search gallery lists these features as of 2026-11-12: Article, Breadcrumb, Carousel, Course list, Dataset, Discussion forum, Education Q&A, Employer aggregate rating, Event, Image metadata, Job posting, Local business, Math solver, Movie, Organization, Product, Profile page, Q&A, Recipe, Review snippet, Software app, Speakable, Subscription and paywalled content, Vacation rental and Video. FAQ is not on that page. Google's changelog on its FAQ structured data page says FAQ rich results stopped appearing on 7 May 2026. We did not find that statement on the gallery page itself, so check Google's FAQ documentation for the current wording.

Choosing a schema method: if the plugin already outputs the type, use it; if not, a schema tool; for one page only, a manual snippet; then test Need a typeon which pages? Plugin has it: use it Missing: schema tool One page: JSON-LD snippet Test the URLerrors first, then warnings
Fewer sources of schema means fewer duplicates to debug.

A minimal manual snippet

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Acme Ltd",
  "url": "https://example.com/",
  "logo": "https://example.com/logo.png"
}
</script>

Print it from a small site-specific plugin or snippet tool hooked to the head output, not from a theme file you may replace. Keep every value identical to what a visitor can read. Google's introduction to structured data says markup should describe visible content.

Picking a type: a few practical rules

  • Match the page. A product page gets Product, a post gets Article, a contact page for a shop with a street address may suit Local business. Do not add a type because it sounds valuable.
  • Keep the graph connected. Yoast's developer documentation describes pieces that reference each other, such as a page pointing at its website and organization. A snippet you add by hand should reuse the same organization name and URL.
  • Review after plugin updates. Output can change when a plugin is updated, so retest a sample of URLs after major releases.

Check before you leave

  1. Run the page through the schema checker and note the types found.
  2. If a type appears twice, switch off one source. A plugin graph plus a manual snippet describing the same organization is the common case.
  3. Read structured data versus schema markup if the terminology is new.
  4. For FAQ content you still want machine-readable, the FAQ schema generator creates the code. Do not expect a rich result from it.

Plan limits and type counts come from vendor pages read on 2026-11-12 and change often. A page that validates is eligible for a feature, which is not the same as being shown with one.

Questions people ask

Do I need a separate schema plugin if I run Yoast, Rank Math or AIOSEO?

Often not for the basics. Yoast documents a JSON-LD graph describing the organization or person, the website and the page. Rank Math and AIOSEO both document schema generators, with some features marked PRO or plan-based. A second plugin risks duplicate output, so test with the schema checker.

Is FAQ schema still worth adding?

Google stopped showing FAQ rich results on 7 May 2026, according to the changelog on Google's FAQ structured data page. The markup remains valid schema.org vocabulary. Add it only if you have another reason, such as tools that read it.

Where does a manual snippet go?

In the page head or body as a script tag of type application/ld+json. In WordPress that is usually a small plugin or a code snippet tool hooked to the head output, so it survives theme changes.

How do I know the markup works?

Run the URL through the schema checker and the Google Rich Results Test, and fix errors before warnings. Passing validation does not guarantee a rich result.

Sources

  1. Google Search Central: FAQ structured data changelog, accessed 2026-11-12.
  2. Google Search Central: Structured data search gallery, accessed 2026-11-12.
  3. Google Search Central: Introduction to structured data, accessed 2026-11-12.
  4. Yoast Developer Docs: Schema integration guidelines, accessed 2026-11-12.
  5. Rank Math: How to use Rank Math's custom schema generator, accessed 2026-11-12.
  6. AIOSEO: Schema settings documentation, accessed 2026-11-12.