INDEXED.
WordPress SEO guide

How to Add FAQ Schema on WordPress

Published · Updated

FAQ schema marks up visible question-and-answer content so machines can read it as structured data. Google stopped showing FAQ rich results in search on 7 May 2026, so the markup no longer creates dropdowns in Google. Any value today is in helping other search engines and AI tools read the Q&A, which Google has not said anything about either way.

The fix on WordPress

Yoast SEO Premium and RankMath both have built-in FAQ schema. In RankMath, use the Schema tab in the post editor and choose FAQ. In Yoast, use the FAQ block.

Builder menus change over time. If a label looks different, look for the closest option and check WordPress's help centre.

What this usually looks like on WordPress

Most WordPress FAQ markup comes from an FAQ block in an SEO plugin (Yoast SEO and Rank Math both offer one) or from a dedicated schema plugin. Google stopped showing FAQ rich results on 7 May 2026, so the markup no longer produces the expandable answers it once did. That changes the reason to add it: you are describing a question-and-answer section clearly to machines, not chasing a search feature.

What to know about WordPress

Schema markup, deep and specific

You choose one plugin

A WordPress plugin can generate 15 or more schema types and stack several on a single page, deeper than any closed platform in this series.

Why this matters

This helps ChatGPT and Google AI Overviews identify your Q&A content as structured data they can extract directly, instead of having to parse it out of regular paragraphs.

Common mistakes on WordPress

  • Adding it for the dropdown

    FAQ rich results are gone, so do not spend hours on markup expecting extra space in the results. If the questions are useful to readers, keep the content on the page. The markup is optional.

  • Markup that does not match the page

    Every question and answer in the markup must also be visible on the page, with the same wording. Hidden or different text goes against structured data guidelines.

  • Two FAQ blocks on one page

    Using a plugin's FAQ block and also pasting your own JSON-LD gives the page two FAQPage definitions. Pick one method.

How to check it worked

  1. Make sure the questions and answers appear as visible text on the page. Markup for content that is not visible can be ignored.
  2. After adding the code, paste the URL into the Schema Markup Validator to check the JSON-LD is valid. Google's Rich Results Test no longer supports FAQ.

Check the page with the Schema Markup Validator at validator.schema.org, because Google's Rich Results Test no longer checks FAQ markup. Confirm there is a single FAQPage block and that it matches the visible text. Then put your effort into the content itself: clear questions, short direct answers, and a page that is useful with or without the markup.

Generate FAQ schema with the Schema Markup Generator →

Common questions

Will FAQ schema give me a rich result in Google?

No. Google stopped showing FAQ rich results on 7 May 2026, and Google has said the markup can stay on the page without harming search performance. Whether other tools use it is not something Google has confirmed.

Where do I paste the code on WordPress?

Into the custom code or header injection area for the page, if the platform offers one. See the steps above for this platform.

Same fix on other builders

Check your WordPress site for free