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.
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.
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 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.
{
"@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.
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.
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.

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.
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.
