How to Add FAQ Schema to WordPress Easily (2026)

FAQ schema is a small block of code that labels the questions and answers on your page. This guide shows you how to add FAQ schema to WordPress by hand and with a plugin, and how to check your work.
One fact first: Google stopped showing FAQ rich results in Search on May 7, 2026. So this guide is honest about what FAQ schema can and cannot do. You can then decide if it is worth adding.
What Is FAQ Schema?
Schema markup is code that describes your page in a way search engines can read. FAQ schema uses a type called FAQPage. FAQPage is still a valid Schema.org type, even though Google no longer shows FAQ rich results.
Most sites write it as JSON-LD, a block of text that sits in your page code and lists your questions and answers. Visitors never see it.
Each entry pairs a Question with an Answer. Here is a simple FAQPage JSON-LD example:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [{
"@type": "Question",
"name": "What is FAQ schema?",
"acceptedAnswer": {
"@type": "Answer",
"text": "FAQ schema labels questions and answers on a page."
}
}]
}
</script>The code must match the text visitors can read on the page.
How to Add FAQ Schema to WordPress
Pick one method. Do not use both for the same content.
Method A: Add FAQ Schema Without Plugin (Custom HTML Block)
This suits you if you do not use Rank Math or Yoast SEO, or only need schema on a few pages.
- Write your questions and answers on the page as normal, visible text.
- Create the code for your first question with a faq schema generator. The free tool on this site makes FAQPage JSON-LD for one question at a time, and its output already includes the
<script type="application/ld+json">wrapper. - Have more questions? Generate each one, then copy the Question items into one mainEntity list, separated by commas. Keep one wrapper per page.
- In the editor, click the plus icon, add a Custom HTML block, and paste the code.
- Preview, update, then test the page using the steps below.
Method B: Use a FAQ Schema WordPress Plugin (Rank Math or Yoast SEO)
Here is how to add FAQ schema to WordPress with a plugin. Rank Math and Yoast SEO both create FAQ schema through their FAQ blocks.
- Open the post or page. Click the plus icon and search for FAQ.
- Add the Rank Math FAQ block or the Yoast FAQ block.
- Type each question and answer into the block, then update the page.
Warning: if a plugin already outputs FAQPage markup for your content, do not add a second copy by hand. Duplicate markup can create messy, conflicting data.
This suits you if you already use Rank Math or Yoast SEO and add FAQs often.
FAQ Rich Results Are Gone — Should You Still Add It?
Google stopped showing FAQ rich results on May 7, 2026. That means no expandable questions under your listing, and schema will not bring them back.
Do not expect better rankings or AI citations from it.
FAQPage is still a valid Schema.org type, so it still describes your content clearly to tools that read it. Add it if you already have a real FAQ section. Skip it if you would have to invent questions just for the code.
Knowing how to add FAQ schema to WordPress is a quick extra step, not a strategy.
How to Check Your FAQ Schema
Use the Schema Markup Validator at validator.schema.org. It checks whether markup follows Schema.org rules.
- Publish or update your page.
- Open the validator and choose Fetch URL.
- Paste your page address and click Run Test.
- Look for FAQPage, with each Question and Answer under it.
- Fix any errors shown.
A pass means your markup is valid. It does not mean Google will show anything special or that rankings will change.
Google’s Rich Results Test checks eligibility for Google-supported rich results. Since FAQ rich results are gone, it will not confirm an FAQ listing.
Frequently Asked Questions
Is FAQPage still a valid schema type?
Yes. Schema.org still lists FAQPage as a valid type. Google only stopped showing FAQ rich results on May 7, 2026.
Will FAQ schema improve my rankings?
There is no promise of that. Add it to describe your content clearly, not to chase rankings or AI citations.
Can I use a plugin and manual code together?
Not for the same content. If a plugin already outputs FAQPage markup, a second copy creates duplicates.
Can the free tool create several questions at once?
No. The free faq schema generator on this site makes one question at a time. Merge the results into one FAQPage block.
Final Thoughts
You now know how to add FAQ schema to WordPress, and it is safe when you add it once and check it. Create your code with our free FAQ schema markup generator, then test it in the Schema Markup Validator.
Want more free tools for your campaigns? Browse the Free Tools directory — every tool runs in your browser, no signup needed.