Yoast SEO and Rank Math both add JSON-LD that describes your site, the page, the author, the breadcrumb trail and the main content. Both can be extended with your own code. Before you write any custom markup, find out which entities the plugin already outputs for the page type you are working on.

The order that works for either plugin is short. Configure the site, content-type, author and breadcrumb settings first. Use the built-in blocks only where they match what visitors can see. Then add custom JSON-LD through Yoast's Schema API or Rank Math's filters, returning the complete entity rather than a second copy of it.

The two plugins differ in how you control the output. Yoast centers on one connected graph. Rank Math lets you choose a schema type globally and per post, so its graph depends on the page type, your settings and the modules you have switched on.

Key takeaways

  1. Read the rendered page firstOpen the rendered page, search for application/ld+json and list each @type before writing custom markup, so you know what the plugin already outputs.
  2. Two different graphsYoast centres on one connected graph of Organization or Person, WebSite and WebPage. Rank Math's graph varies by page type, settings and modules.
  3. Free covers the basicsBoth free versions output standard schema. Rank Math's documentation says its Custom Schema tab is not operational in the free version.
  4. Return the whole entityExtend Yoast through its Schema API and Rank Math through filters. A Rank Math filter must return the complete modified entity, not only the changed field.
  5. Avoid duplicatesRemove or merge a second Article, Product, FAQPage or BreadcrumbList, and settle on one plugin's schema output rather than running both.
  6. Test in more toolsTest the rendered page in Google, Bing and Yandex tools, because each applies different rules. A clean result is not a promise of a rich result.

What Yoast SEO adds by default

Yoast's developer specification describes a base graph made of Organization or Person, WebSite and WebPage. On posts, Yoast commonly adds an Article, a Person for the author and a BreadcrumbList. Each piece links to the others with @id, which is a stable identifier that lets one entity point at another instead of repeating it. The Schema output page for the plugin lists the same core pieces.

The defaults follow the content type. Yoast's content types settings set pages to WebPage and posts to Article plus WebPage, and you can change them there. Yoast's documentation warns that a change in those defaults applies to all content of that type, so test one post and one page before you save a sitewide change.

Other graph pieces depend on the page and on integrations. Yoast documents output for products, videos, recipes, events, FAQs and HowTo blocks, and for WooCommerce, Easy Digital Downloads, WP Recipe Maker and The Events Calendar, among others.

The Schema settings cover how the site is represented, as an organization or a person, and the social profiles listed through sameAs. They also include the breadcrumb settings and a per-page Schema selection in the editor. Yoast says the connected-graph setting should normally stay on, because it is what produces the linked output described above. The implementation guide explains how these pieces fit together.

What Rank Math adds by default

Rank Math adds JSON-LD for site and page entities, and the administrator chooses schema types globally and per post. Its schema documentation says the exact graph varies by page type, settings and enabled modules, so the output on your blog post may differ from the output on a product page or a custom post type.

Common output can include WebSite, Organization or Person, WebPage, Article and BreadcrumbList. Depending on the type you select, Rank Math can also output product, recipe, event, video, FAQ, HowTo, local business, course, job posting and review markup.

The settings that shape the result are the Default Schema Type for posts, pages and custom post types, the per-page Schema Generator settings, the breadcrumb controls and the schema blocks. Rank Math's documentation also lists multiple schema types, Custom Schema and schema templates as Pro features, which the next section covers.

Because the graph depends on settings, Rank Math owners get the most from opening the rendered page and reading what came out, rather than assuming a type from the dropdown. A selected type that does not match the visible page content is a setting to change, not a gap to fill with custom code.

Free and paid schema controls

On the Yoast side, the free plugin provides the core connected graph, the standard graph pieces, content-type settings, author and site representation controls, breadcrumbs and the standard integrations. Premium is not required for that basic graph. Some schema additions arrive through separate add-ons such as Local SEO, Video SEO, News SEO or WooCommerce SEO. Yoast's content types documentation also identifies the custom fields option as a Premium feature, intended for developers who use it with filters.

On the Rank Math side, the free version provides standard schema types and basic per-post schema controls. Rank Math's documentation says the Custom Schema tab is not operational in the free version. The Custom Schema Generator and reusable schema templates are listed as Pro features, along with multiple schema types and further advanced controls.

Feature availability changes over time, so check the interface of the version you have installed before planning around a specific type. A paid control only helps when the page actually contains the matching content, and neither plugin's paid tier carries a promise about rankings or rich results.

For most pages, the free default graph from either plugin already covers the site, page, author and breadcrumb entities. The choice usually comes down to which settings screen and extension route you prefer to work with.

Default output and free or paid controls

Hover over or tap a row to highlight it. On small screens the table scrolls sideways.

AreaYoast SEORank Math
Site and page entitiesConnected graph of Organization or Person, WebSite and WebPage.JSON-LD for site and page entities; graph varies by page type, settings and modules.
On a blog postCommonly adds Article, author Person and BreadcrumbList, linked with @id.Output follows the schema type chosen globally or per post.
Type controlContent-type defaults plus a per-page Schema selection in the editor.Default Schema Type per content type plus per-page Schema Generator settings.
Free versionCore graph, content-type settings, breadcrumbs and standard integrations.Standard schema types and basic per-post controls. Custom Schema tab is not operational.
Paid featuresCustom fields option for developers in Premium; some schema through add-ons.Custom Schema Generator, reusable templates and multiple schema types in Pro.
Extension routeSchema API to add, remove or modify graph pieces.rank_math/json_ld filter and entity filters returning the complete entity.

Check what is on your page before adding anything

The fastest way to know what a plugin outputs is to read the rendered page. Open a post in your browser, view the page source and search for application/ld+json. Each block you find is a script element holding JSON-LD. Note whether the blocks sit in one @graph array or in several separate scripts, and write down which @type values appear.

Then name the source of each entity. A graph with WebSite, WebPage, Article, Person and BreadcrumbList linked by @id is typical of the plugin's own output. A separate Article or Organization block with different @id values often comes from a theme or another plugin, and that is where duplicates begin.

A man at a small table in a print shop back room scrolls a laptop while holding a mug
Figure 1. Reading the rendered page source shows which entities the plugin already outputs before any custom code is added.

A small example shows what a connected result looks like. This fictional graph uses example.com URLs and trims several properties for length. The Article points to its WebPage and publisher, and the WebPage points to the BreadcrumbList. Replace the names, URLs and dates with the facts that appear on your own page.

json
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "Article",
      "@id": "https://example.com/blog/example-article/#article",
      "isPartOf": { "@id": "https://example.com/blog/example-article/" },
      "mainEntityOfPage": { "@id": "https://example.com/blog/example-article/" },
      "headline": "A Fictional Guide to Structured Data",
      "image": ["https://example.com/images/example-article-16x9.jpg"],
      "author": {
        "@type": "Person",
        "@id": "https://example.com/about/example-author/#person",
        "name": "Example Author",
        "url": "https://example.com/about/example-author/"
      },
      "publisher": { "@id": "https://example.com/#organization" },
      "datePublished": "2026-01-15T09:00:00-06:00",
      "dateModified": "2026-02-01T10:30:00-06:00",
      "articleSection": "Guides",
      "inLanguage": "en-US"
    },
    {
      "@type": "WebPage",
      "@id": "https://example.com/blog/example-article/",
      "url": "https://example.com/blog/example-article/",
      "name": "A Fictional Guide to Structured Data",
      "isPartOf": { "@id": "https://example.com/#website" },
      "breadcrumb": { "@id": "https://example.com/blog/example-article/#breadcrumb" },
      "inLanguage": "en-US"
    },
    {
      "@type": "WebSite",
      "@id": "https://example.com/#website",
      "url": "https://example.com/",
      "name": "Example Publishing",
      "publisher": { "@id": "https://example.com/#organization" }
    },
    {
      "@type": "Organization",
      "@id": "https://example.com/#organization",
      "name": "Example Publishing",
      "url": "https://example.com/"
    },
    {
      "@type": "BreadcrumbList",
      "@id": "https://example.com/blog/example-article/#breadcrumb",
      "itemListElement": [
        { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://example.com/" },
        { "@type": "ListItem", "position": 2, "name": "Blog", "item": "https://example.com/blog/" },
        { "@type": "ListItem", "position": 3, "name": "A Fictional Guide to Structured Data" }
      ]
    }
  ]
}

Google's Article documentation says no Article properties are required for that feature. It lists headline, image, author, datePublished and dateModified as recommended, and these fields remain useful for clarity. Google's breadcrumb documentation requires at least two ListItem objects, each with position and name, and an item URL for entries that represent a page. The last entry may omit item. Those are Google's feature rules, not requirements for Bing, Yandex or Apple. The Schema.org Article page defines the vocabulary itself.

If the Organization on your site needs its own definition, the guide on Organization schema on every page explains where to define it once and reference it elsewhere. The guide to schema markup on WordPress covers the wider set of installation routes.

Extend Yoast with its Schema API

Yoast's Schema API lets developers add graph pieces, remove them and modify existing ones. It also lets them connect custom entities with @id, integrate third-party plugins and custom post types, and prevent duplicate output from another system. The point of the API is that your addition joins the graph Yoast already prints instead of arriving as an unrelated second graph.

Start with the Yoast Schema output page and the integration documentation, and confirm the function and filter names against the plugin version you have installed, since those names are the part most likely to change. Use stable IDs for anything you add, and describe only content that visitors can see on the page.

A practical order for Yoast is to settle the representation and defaults first. Set whether the site is an organization or a person, add the social profiles, and check the content-type defaults and breadcrumb settings. Then use Yoast's FAQ and HowTo blocks only on pages where the visible content really is a set of questions or a set of steps. Add custom code last, for an entity the plugin does not produce, such as a video that appears on the page.

Extend Rank Math with filters

Rank Math documents a general filter, rank_math/json_ld, that modifies the JSON-LD data array before output. Its filters and hooks page shows the pattern below. The function receives the data and the JSON-LD object, and as written it returns the data unchanged, so it is a starting point rather than a finished customization.

php
add_filter( 'rank_math/json_ld', function( $data, $jsonld ) {
    return $data;
}, 99, 2 );

For one entity, Rank Math documents entity-specific filters. The example below changes the Article entity by adding an articleSection value. Replace Guides with the section name that matches your own site.

php
add_filter( 'rank_math/snippet/rich_snippet_article_entity', function( $entity ) {
    $entity['articleSection'] = 'Guides';
    return $entity;
} );

Two rules apply to every filter of this kind. The schema name in the filter must match the entity you are modifying, and the function must return the complete modified entity, preserving the valid data that was already there. Returning only the field you changed would drop the rest.

Rank Math recommends placing customizations in a dedicated rank-math.php file in the active theme, so they run only when Rank Math is active; use a child theme so a theme update does not remove them. A small custom plugin or a child theme is another maintainable home for the code.

Avoid duplicate Article, Product, FAQPage and BreadcrumbList entities

A second copy of an entity is the usual way a custom addition goes wrong. If the plugin already outputs an Article for a post, a second Article block from a snippet, a theme or another plugin gives search systems two descriptions of the same thing, and they can disagree about the headline, the author or the dates. The same applies to Product, FAQPage and BreadcrumbList.

A row of four slot cards where one slot holds two identical cards and the upper copy lifts away toward a magnifier
Figure 2. Two descriptions of the same entity should end up as one, either by removing the extra or merging it into the plugin's entity.

Work through the page source in three steps. First, list each entity type and count how many times it appears for the main content. Second, find the source of any extra, whether it is the theme, another plugin or your own script. Third, either turn off the extra output at its source or merge it into the plugin's entity through a filter. Keep separate entities only when the page visibly contains separate things, such as a video, a product, a recipe or an event, and give each its own @id.

Google's general structured data guidelines say markup should describe visible content, and they allow multiple entities on a page. Multiple valid entities are fine. The risk is conflicting duplicates of one entity. Guides on Article schema, breadcrumb schema and the JSON-LD graph go deeper on each piece.

Running both plugins at once invites overlapping output, because each can emit the same entities. Settle on one plugin's schema output for the site, then use the filters above for anything custom.

Extend plugin schema in order

  1. Identify the contentNote the main content visitors can see on the page, such as an article, a product or a video.
  2. Configure the pluginSet site representation, content-type defaults, author and breadcrumb settings first.
  3. Inspect the outputOpen the rendered source and list each @type that appears and where it comes from.
  4. Remove duplicatesTurn off or merge a second Article, Product, FAQPage or BreadcrumbList.
  5. Add missing entitiesAdd only truthful entities through the plugin's filters, using stable @id values.
  6. Validate and recheckTest with Google, Bing, Yandex and Schema Nova tools, then test again after plugin or theme changes.

Switch between Yoast and Rank Math

Both vendors document importers. Moving from Rank Math to Yoast, Yoast's migration steps start with a site backup. You then deactivate Rank Math, install Yoast SEO, open Tools, then Import and Export, choose Import from other SEO plugins and select Rank Math. Afterwards, confirm titles, descriptions, keyphrases, redirects and page output, complete Yoast's first-time configuration and remove the old data only after verification. Yoast's import and export page lists the import options and notes which ones are Premium.

Moving from Yoast to Rank Math, Rank Math's migration guide also starts with a backup. You install Rank Math, then run the Setup Wizard or open Status and Tools, then Import and Export, and select the Yoast SEO importer. Review titles, descriptions, canonical URLs, redirects and social metadata. If you used Yoast FAQ or HowTo blocks, Rank Math's Yoast Block Converter handles them. Verify the rendered JSON-LD after the switch, and remove the old plugin only once the new output is confirmed. Rank Math's import and export documentation covers the importer behavior.

Importing SEO fields is not the same as carrying over every generated graph node or custom integration, and export formats are not interchangeable between plugins. Before you switch, save the old plugin's JSON-LD for a representative post, page and product, and keep any custom code. After activation, compare the new output with the saved copy and look for duplicate JSON-LD.

Test the output in Google, Bing and Yandex tools

Google's Rich Results Test and URL Inspection show how Google reads a page. Bing's structured data documentation says it supports Schema.org in JSON-LD, Microdata and RDFa, so the same plugin output serves both, and the Markup card in Bing's URL Inspection tool shows what Bing found. Yandex provides a structured data validator and says in its markup FAQ that it does not support every Schema.org type, so use Yandex's own requirements for Yandex displays. The Schema Nova schema validator is another place to paste a block or check a page.

To let ChatGPT search and Perplexity reach the page, allow OAI-SearchBot and PerplexityBot in robots.txt, as OpenAI's ChatGPT search help page and Perplexity's crawler guide describe. Accurate markup stays useful either way; see whether AI systems use schema markup.

Which Google displays still exist

A type in the Schema.org vocabulary and a feature in Google Search are separate things. Google's Search gallery lists the structured data features Google Search supports, including Article, Breadcrumb, Organization, Product, Recipe, Review Snippet, Video and Local Business. A type that is not in the gallery is still valid Schema.org markup when it describes the page truthfully.

Google says FAQ rich results stopped appearing in Google Search on May 7, 2026, so FAQPage stays valid vocabulary with no current Google display. Google also said in June 2025 that it was simplifying the search results page by retiring several structured data displays, and that the change did not affect rankings, in a post called Simplifying the search results page. A visible FAQ section can still help readers, and other systems may read the markup, but it should not be presented as a current Google rich result.

The same distinction applies to WebSite, WebPage, Person and Organization as general descriptions. They do real work in the connected graph, because other entities point to them, even where Google lists no specific display for them. Re-check the Search gallery before you add a type for a Google display, because feature support changes.

Questions people ask

What schema does Yoast SEO add by default?

Yoast's developer specification describes a base graph of Organization or Person, WebSite and WebPage. On posts it commonly adds an Article, the author as a Person and a BreadcrumbList, linked with @id. Extra pieces depend on the page and your integrations, such as WooCommerce or the plugin's FAQ and HowTo blocks.

What schema does Rank Math add by default?

Rank Math adds JSON-LD for site and page entities, and you choose a schema type globally and per post. Common output includes WebSite, Organization or Person, WebPage, Article and BreadcrumbList. The exact graph depends on the page type, your settings and the modules you have enabled.

Is Rank Math's custom schema available in the free version?

Rank Math's documentation says the Custom Schema tab is not operational in the free version. It lists the Custom Schema Generator and reusable schema templates as Pro features.

Can Yoast and Rank Math run together?

Both plugins can output overlapping entities, which risks conflicting or duplicate JSON-LD. Each vendor's migration steps describe a one-way move, with the old plugin removed after the new output is confirmed. Pick one plugin for schema output and extend it through its own filters.

How do I test JSON-LD?

Open the rendered page source and find the application/ld+json scripts, then run the URL through Google's Rich Results Test, Bing Webmaster Tools, Yandex's validator and the Schema Nova validator. Each tool checks different rules. A clean result still does not guarantee a rich result, a display or an AI citation.

What is the difference between Schema.org and Google rich results?

Schema.org is a shared vocabulary of types and properties for describing things on the web. JSON-LD is one format for writing that vocabulary into a page, and structured data is the general name for the result. A rich result is a richer appearance that a search engine may show when its own requirements are met, and Google says valid markup does not guarantee one.

Does FAQ schema still produce Google rich results?

Google says FAQ rich results stopped appearing in Google Search on May 7, 2026. FAQPage remains valid Schema.org vocabulary. The FAQ schema guide covers what to do with an existing FAQ section.

Quick check: add another block?

Choose an answer to see feedback. Nothing is scored or saved.

Question 1 of 3

A plugin already outputs an Article for a blog post, and the page has no separate recipe, product, video or event. What should you do?

Question 2 of 3

A Rank Math filter changes the Article entity. What must the function return?

Question 3 of 3

You import SEO fields from the old plugin after a switch. What does that tell you about the JSON-LD?

Terms used in the plugin comparison

Select a term to see its definition.

Schema.org. A shared vocabulary for describing entities and relationships on the web.