Plugin how-tos · Guide
How Do Rank Math Schema Settings Work?
Short answer
Rank Math schema settings add structured data to your WordPress posts and pages so search engines can tell what each page is. You set a default schema type for each post type in Rank Math SEO, Titles and Meta, then change single posts in the Schema tab of the editor. Rank Math uses Article for posts and pages by default, as of November 2026.
Key takeaways
- Rank Math uses Article schema for posts and pages by default, and you can change that default in Titles and Meta.
- The Schema tab only appears when the Schema module is enabled under Rank Math SEO, Dashboard, Modules.
- Article schema has 3 types: Article, Blog Post, and News Article, and Google advises using the most specific type.
- Multiple schema types, Schema Templates, and Custom Schema are PRO features in Rank Math, as of November 2026.
- Google ended FAQ rich results in 2026, so FAQ schema no longer earns that visible result in search.
- A valid Rich Results Test result means a page is eligible for a rich result, not that Google will show one.
What is Rank Math schema?
Rank Math schema is structured data that tells search engines what a page is, such as an article, a product, or an event.
Schema is code added to a page in JSON-LD format, and Rank Math writes that code for you from the settings you pick. Rank Math's Article Schema guide says Article Schema helps search engines understand the headline, published date, and primary image of an article.
A schema type is a label from the schema.org vocabulary, and each type has its own fields. Article needs a headline, while Product needs a name and an offer, so picking the wrong type leaves the wrong fields on the page.
Rank Math is used on 4+ million WordPress sites, and its WordPress.org listing lists 16+ schema types in the free version, as of November 2026. That count is a floor for the free plugin, and PRO adds more types and tools.
Where are the Rank Math schema settings?
Rank Math schema settings live in 3 places: the Dashboard modules list, Titles and Meta, and the Schema tab in the post editor.
First, open Rank Math SEO, then Dashboard, then Modules, and turn on the Schema (Structured Data) module. Rank Math's Article Schema guide says the Schema tab will not appear in the editor until this module is on.
Second, open Rank Math SEO, then Titles and Meta, to set defaults for each post type. Rank Math's Titles and Meta guide says these settings create a default set that new posts inherit, and you can override them on single posts.
Third, open a single post or page and use the Schema tab in the Rank Math box to change that page only. If you are new to the plugin, read our guide on how to set up Rank Math before you change schema defaults.
Some settings appear only in Advanced Mode, so switch modes if a schema option is missing. The Titles and Meta page also has a search box at the top, and you can type “Schema Type” to jump to the right field.
What is the default schema type for posts and pages?
Rank Math uses Article for posts and pages by default.
You can change that default at WordPress Dashboard, Rank Math SEO, Titles and Meta, then Posts or Pages, in the Schema Type drop-down. Rank Math's Article Schema guide gives this exact path and says you can pick any built-in type there.
Leave Schema Type at none if you want new posts to have no schema until you set it by hand. Rank Math's Titles and Meta guide says the Headline and Description fields appear only after you pick a Schema Type.
The default matters because every new post inherits it, so a blog that mostly publishes guides should keep Article or Blog Post as the default. A shop should set Product as the default for its product post type instead, and leave posts on Article.
| Post type | Sensible default | Why |
|---|---|---|
| Posts | Article or Blog Post | Most posts are articles, and Blog Post is the more specific type |
| Pages | Article | Pages often describe a service or topic, and Article fits general pages |
| Products | Product | Product schema carries name, price, and availability fields |
| Events | Event | Event schema carries date, time, and location fields |
| None | None | Use this when you want to set schema by hand on each page |
How do you add schema to a single post or page?
Open the post, open the Rank Math Schema tab, pick a type in the Schema Generator, fill in its fields, and save.
Follow these steps in the block editor:
- Edit the post or page, then click the Rank Math SEO icon at the top of the editor to open its panel.
- Click the Schema tab, then click Schema Generator to see the list of types.
- Find the type that matches the page, such as Article, FAQ, or Product, and click Use to open the Schema Builder.
- Fill in the fields the builder shows, such as headline and description, and leave the default variables in place unless you have a reason to change them.
- Click Save for this Post, then click Update or Publish on the post itself.
In the classic editor, scroll down to the Rank Math box below the content and click the same Schema tab there. The steps are the same after that point, and the builder shows the same fields.
Allow about 10 minutes for one page the first time, and about 2 minutes per page once you know the fields. The time goes to matching the type to the page and checking the visible content, not to typing.
Which schema type should you pick for common pages?
Pick the type that matches what a visitor sees on the page, not the type you wish the page ranked for.
Google's general structured data guidelines say to use the most specific applicable type and property names from schema.org. Google's guidelines also say your structured data must be a true picture of the page content.
Use this short list as a starting point:
- Article or Blog Post for blog posts, news posts, and guides.
- Product for a page that sells one item, with its price and stock shown.
- Event for a concert, class, or meetup with a date and a place.
- Recipe for a page with ingredients and steps a reader can follow.
- FAQ for a page with a visible list of questions and answers.
- Video for a page built around one video, or turn on Autodetect Video in Titles and Meta so Rank Math can generate Video Schema from videos it finds.
Do not label a guide as a Recipe, or a product page as an Event, just to chase a display format. Google lists a woodworking site labelling instructions as recipes as an example of irrelevant data in its guidelines.
What do headline, description, and keywords do in Article schema?
Headline, description, and keywords tell search engines the title, summary, and focus words of an article.
Rank Math fills these fields with variables by default. Rank Math's Article Schema guide says the headline uses %seo_title%, the description uses %seo_description%, and the keywords field uses %keywords%.
The headline variable pulls in the SEO title you set for the post, so change the SEO title if the headline looks wrong. The description variable pulls in the meta description, so write a meta description that matches the article.
The keywords field pulls in the focus keywords you set for the post. Rank Math says you can add keywords by hand if you wish, separated by commas, but adding a large number can do more harm than good.
Keep the headline short enough to read on a small screen, even though Rank Math says it has no character limit. Search engines can cut off long titles on mobile, so a short headline is safer.
What are the 3 Article types in Rank Math?
Rank Math offers Article, Blog Post, and News Article as the 3 Article types.
Article is the general type, and Rank Math sets it by default. Rank Math's Article Schema guide says BlogPosting is a more specific type of Article under the Schema.org hierarchy, so pick Blog Post for ordinary blog posts.
News Article is only for factual news content on a news site. Rank Math says Google does not allow a person as the publisher for news articles, so the publisher must be an Organization, and Rank Math adds it automatically.
If you mark a post as news in the News Sitemap settings, Rank Math sets its schema to NewsArticle even if you picked Article or BlogPosting in Titles and Meta. Do not use News Article for guides, reviews, or opinion posts, because Google's Rich Results Test can flag the mismatch.
Author URL is another field worth checking. Rank Math adds the author URL to Article Schema automatically if author archives are enabled, and you can check that at Rank Math SEO, Titles and Meta, Authors, Author Archives.
What is free and what is PRO in Rank Math schema?
The free plugin covers single schema types per post, while PRO adds multiple types, templates, and custom schema.
Rank Math's free version includes the Schema module, the Schema Generator, and the built-in types such as Article, Product, Event, and FAQ. You can set a default type per post type and change it on single posts without paying.
PRO adds 3 things that matter most for larger sites:
- Multiple schema types on one post or page, with a Primary Schema you pick in the generator.
- Schema Templates, which save a schema set-up so you can reuse it on other posts.
- Custom Schema Builder, which lets you build a type from properties and property groups when no built-in type fits.
Rank Math's multiple schema guide says adding more than one schema type needs Rank Math PRO, and you pick the Primary Schema after you add the types. PRO also adds Speakable for Article schema, which lets you mark parts of an article for audio playback with cssSelectors such as .headline and .summary.
If you are weighing the paid plan against another plugin, read our Yoast vs Rank Math settings side by side before you decide.
Our Rank Math vs Yoast comparison covers the two plugins as a whole, including install counts and free features.
If you already use Yoast, our guide on how to import Yoast settings into Rank Math covers the switch.
How do Schema Templates and Custom Schema work?
Schema Templates save a schema set-up so you can apply it again without building it from scratch each time.
Templates are a PRO feature. Open WordPress Dashboard, Rank Math SEO, then Schema Templates, and click Add New Schema to start one, or click Save as Template from a schema you built on a single post.
The Custom Schema Builder lets you add properties and property groups to build a type that is not in the built-in list. You can start from a blank template, add the fields you need, and save it as a template for reuse.
Templates also have a Display Conditions tab, which controls where the template applies, such as a post type or a category. Set the conditions before you save, or the template may appear on pages where it does not belong.
Use Code Validation in the builder to see the JSON-LD code Rank Math will output. Read that code once before you publish, and check that the names, dates, and URLs in it match the visible page.
How do you check that your schema works?
Run the page through Google's Rich Results Test and the Schema Markup Validator, then fix every error the tools report.
Google's guidelines say you can test technical compliance with the Rich Results Test and the URL Inspection tool, which catch most technical errors. Paste the live URL, or paste a code snippet if the page is not public yet.
The Rich Results Test lists each rich result type it finds, with errors or warnings for each one. Errors make that item ineligible for a rich result, while warnings mean optional fields are missing.
Use the Schema Markup Validator as a second check, because it tests any schema.org markup, not only the types Google uses for rich results. Rank Math's FAQ guide points readers to this validator and says to paste a URL or a code snippet and click Run test.
A pass in either tool does not promise a rich result. Google says it does not guarantee that structured data will show up in search results, even if the page is marked up correctly and passes the Rich Results Test.
After a fix, ask Google to recrawl the page in Search Console with the URL Inspection tool and Request Indexing. Allow days for the change to show, because Google recrawls pages on its own schedule.
What mistakes should you avoid?
Do not add schema for content that is not visible on the page, do not copy schema from another site, and do not expect a rich result from every page.
Google's guidelines say not to mark up content that readers cannot see, and not to mark up irrelevant or misleading content such as fake reviews. If the JSON-LD describes a performer, the page body must describe that same performer, as Google's own example puts it.
Avoid these common errors:
- Picking a type for its display format instead of its match to the page.
- Leaving required fields blank, which makes the item ineligible for a rich result.
- Adding FAQ schema to questions that are hidden from visitors, or to a forum where many users answer one question.
- Adding HowTo schema to chase a HowTo result, since Google retired HowTo rich results, and adding FAQ schema to chase an FAQ result, since Google ended FAQ rich results in 2026.
- Turning the Schema module off by accident, which removes the Schema tab and stops Rank Math from outputting schema.
- Blocking the page with robots.txt or noindex, which Google says stops it from testing or showing structured data on that page.
A structured data manual action removes rich result eligibility but does not affect how the page ranks in web search, according to Google's guidelines. Check the Manual Actions report in Search Console if a rich result disappears after a change.
Frequently asked questions
Does Rank Math add schema automatically?
Yes, for the default type. Rank Math adds Article schema to posts and pages by default once the Schema module is on, using the headline, description, and keywords from your SEO settings. You still need to pick the right type for products, events, and other pages, and fill in any fields the default variables do not cover.
Can I use a different schema type on one post without changing the default?
Yes. Open the post, click the Schema tab in the Rank Math panel, then open the Schema Generator and pick another type for that post only. Click Save for this Post, then update the post. The default in Titles and Meta stays the same for all other posts.
Why is my schema not showing a rich result in Google?
A rich result is never promised, even when the markup passes the Rich Results Test. Google may decide the page does not qualify, the type may no longer have a rich result, or a required field may be missing. Check the test for errors, confirm the page is indexed and not blocked, and check Search Console for a manual action.
Should I still add FAQ schema in 2026?
Only if the questions and answers are visible on the page and help readers. Google ended FAQ rich results in 2026, so FAQ schema no longer earns that visible result in search. It can still help search engines and AI tools understand the page, but do not add it only to chase a result that no longer exists.
Do I need Rank Math PRO for schema?
No, for basic schema. The free plugin includes the Schema module, the Schema Generator, and built-in types such as Article, Product, Event, and FAQ. PRO is needed for multiple schema types on one page, Schema Templates, the Custom Schema Builder, and Speakable, as of November 2026.
What should I do if the Schema tab is missing?
First check Rank Math SEO, Dashboard, Modules, and turn on the Schema module. Then check that you are in Advanced Mode, since some options only appear there. Also check Titles and Meta for that post type, and make sure Add SEO Controls is on for the post type you are editing.
Sources
- Article Schema Type Rank Math
- Rank Math Titles and Meta Options and Settings Rank Math
- How to Use Multiple Schema Markup Types With Rank Math PRO Rank Math
- FAQ Schema: A Practical Guide Rank Math
- General Structured Data Guidelines Google Search Central
- Rank Math SEO plugin WordPress.org
- Rich Results Test Google Search Console Help
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
