Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared Managed Cloud India
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Best lists Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

SEO & AI search · Guide

How to Add FAQ Schema in WordPress

Short answer

Add FAQ schema in WordPress by inserting a FAQ block from Rank Math or Yoast SEO, filling in each visible question and answer, then publishing the page. The plugin writes FAQPage JSON-LD for you, so you do not need to write code. Or paste a short FAQPage JSON-LD block into a Custom HTML block, then check it with the Schema Markup Validator.

Key takeaways

  • FAQ schema labels visible questions and answers with FAQPage JSON-LD, using one Question and one accepted answer per item.
  • Google stopped showing FAQ rich results on 7 May 2026, so add the markup for readers and machines, not for an expanded listing.
  • Rank Math and Yoast SEO both add FAQPage markup automatically when you use their free FAQ blocks.
  • Every question and answer in the markup must match text readers can see on the page.
  • Check the result with the Schema Markup Validator, then ask Google to recrawl the page in Search Console.

What is question-and-answer schema in WordPress?

FAQ schema is structured data that labels a page's visible questions and answers so software can read each pair as a question and one accepted answer.

Schema.org defines FAQPage as a WebPage that presents one or more frequently asked questions, and its page gives the canonical URL for the type (FAQPage).

Schema.org shows the markup as JSON-LD, a block of JSON in a script tag. It sets @context to https://schema.org, @type to FAQPage, and mainEntity to a list of Question items. Each Question holds a name with the question text and an acceptedAnswer with an Answer whose text holds the answer.

A WordPress plugin writes that block for you when you use its FAQ block. You type the questions and answers in the editor, and the plugin adds the matching JSON-LD to the page. That keeps the visible text and the markup in step, which is the point of the whole job.

Does Google still show rich results for question pages?

No, Google stopped showing FAQ rich results in Google Search on 7 May 2026, so FAQ schema no longer changes how a listing looks there.

Google Search Central recorded the change in its documentation updates log on 8 May 2026, with the reason that the feature would no longer appear in Google Search starting 7 May 2026 (documentation updates).

The same log records a second step on 15 June 2026: Google removed the documentation for the FAQ rich result feature because it was no longer shown in Search. The old FAQ guide URL now leads to that changelog entry, so do not link to it as live guidance.

Rank Math states the same result in plain terms: Google ended support for FAQ schema in 2026 and no longer displays rich snippets for it, while the markup can still help AI platforms read the page (FAQ schema guide).

Yoast SEO is clear on the wider point, too: schema does not directly boost rankings, though it can make content more attractive in search (structured data).

That leaves one honest reason to add FAQ schema: a clear, machine-readable record of answers that readers already see. Add it where a real set of questions exists, and skip it where the questions are invented for markup alone.

What do you need before you add this schema?

You need a WordPress page or post with a real set of questions, an SEO plugin or a way to paste JSON-LD, and access to the block editor.

  • A short list of 4 to 6 questions your readers ask, in their own words, with a full answer for each one.
  • One SEO plugin only: Rank Math or Yoast SEO, not both, so the page does not get two sets of FAQ markup.
  • Editor access to the page, plus a draft copy if you plan to edit live content.
  • A live URL you can open after publishing, so you can run the validator on the finished page.

Write the answers first, in plain text, before you touch any block or code. If an answer is missing, thin, or hidden from readers, fix the page first and add the markup second.

Schema.org reports FAQPage use on 1 million to 10 million domains, based on Google's web index in August 2026 (FAQPage). That range shows the type is common, even though Google no longer draws a FAQ result from it.

How do you add this schema with Rank Math?

Add FAQ schema with Rank Math by inserting its FAQ block in the block editor, typing each question and answer, then publishing the page.

  1. Go to Plugins > Add New in the WordPress dashboard, search for Rank Math, then click Install Now and Activate.
  2. Open the post or page in the block editor and click the + icon to add a block.
  3. Search for FAQ by Rank Math and select the FAQ block.
  4. Type the question in the question field and the full answer in the answer field, then add the next question the same way.
  5. Publish or update the page so Rank Math writes the FAQPage JSON-LD into the page.

Rank Math says you are not limited to one FAQ block per page, so you can add as many blocks as the content needs (FAQ schema guide).

If you have not set the plugin up yet, follow the Rank Math setup steps in How to Set Up Rank Math before you add the block.

Rank Math also offers reorder controls, but the up and down buttons for moving questions are a Rank Math PRO feature, so free users should put questions in final order as they type them.

What if you use the Classic Editor?

If you use the Classic Editor, Rank Math PRO offers an Advanced Schema Generator. Open the post, scroll to the Rank Math meta box, open the Schema tab, pick FAQ Schema, and fill in the fields. The generator gives you a shortcode to show the questions on the front end.

How do you add this schema with Yoast SEO?

Add FAQ schema with Yoast SEO by inserting its FAQ block in the block editor, filling in each question and answer, then publishing the page.

  1. Go to Plugins > Add New, search for Yoast SEO, then click Install Now and Activate.
  2. Open the post or page in the block editor and click the + icon to add a block.
  3. Search for FAQ and select the Yoast FAQ block under the structured data blocks.
  4. Type each question and its full answer in the block fields, then add the next question.
  5. Publish or update the page, and Yoast adds the FAQPage markup to the schema graph it builds for the page.

Yoast SEO builds one connected schema graph per page and adds the FAQ block markup to it, so the questions and answers stay tied to the page they sit on (structured data).

Yoast lists FAQPage and Question among the schema types in its free plan, and it says schema is included in Yoast SEO for free. That makes the FAQ block a free feature, not a paid add-on.

If the plugin is new to you, work through How to Set Up Yoast SEO first, then come back to the FAQ block.

Yoast says its FAQ and How-to blocks output structured data automatically, and that the blocks need no code from you. You only write the questions and answers that readers see.

How do you add this schema by hand with JSON-LD?

Add FAQ schema by hand by pasting a FAQPage JSON-LD script into a Custom HTML block, with the same questions and answers that appear on the page.

Use this route only when you do not use Rank Math or Yoast SEO, or when your editor cannot use their blocks. One source of FAQ markup per page is enough, so do not run a plugin block and a hand-written script together.

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "How long does delivery take?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Delivery takes 3 to 5 working days."
      }
    }
  ]
}
  1. Write the questions and answers on the page first, in normal blocks.
  2. Add a Custom HTML block below the visible FAQ section.
  3. Paste the JSON-LD script into the block, with your own question and answer text in place of the example.
  4. Update the page, then view the page source and check that the script appears once.

Rank Math notes the same rule for hand-written markup: the questions and answers in the code must also appear in the visible HTML of the page. Markup that readers cannot see breaks the basic rule for structured data.

How do you check that your schema works?

Check FAQ schema with the Schema Markup Validator by fetching the live URL or pasting the code, then running the test and reading the errors.

Rank Math points to the Schema Markup Validator for this job: paste the page URL or the code snippet, click Run test, and look for a result with zero errors and zero warnings (Schema Markup Validator).

The Rich Results Test is the wrong tool for this job now, because Google no longer shows FAQ rich results. Use it for types Google still shows, and use the validator for FAQPage.

  • Open the live page in a private browser window and read every answer.
  • Run the validator on the live URL and fix any error it reports.
  • Compare the markup text with the visible text, word for word, for each question.
  • Ask Google to recrawl the page in Search Console with Request Indexing.

For the wider schema settings on a Rank Math site, see How Do Rank Math Schema Settings Work before you change a type on a live page.

A clean validator result means the code parses, not that Google will show anything special. Google stopped showing FAQ results on 7 May 2026, so a pass here is a code check, not a promise of a new listing.

When should you use this schema, and when should you skip it?

Use FAQ schema only on a page with a real set of questions and answers that readers can see, and skip it on pages with no genuine FAQ section.

Rank Math lists the invalid cases in plain terms: a forum with user answers, a page where users can submit more than one answer, an advertising page, and questions that readers cannot see on the page.

Page typeAdd FAQ schema?Why
Support page with 4 to 6 real questionsYesReaders see the same questions and answers
Product page with a short question and answer sectionYesThe questions match the page topic
Forum thread with user answersNoUser answers belong under QAPage, not FAQPage
Page with no questions at allNoThe markup would describe content readers cannot see
Advertising pageNoAn FAQ page used for advertising is an invalid use case

Yoast SEO says its structured data covers more than 50 schema types, so FAQPage is one small piece of a wider system (structured data).

If you want the wider picture first, read Yoast SEO settings explained to see where schema fits among the other settings.

Article schema and general schema markup are separate topics with their own guides, so this page stays on FAQPage alone. If a page needs Article markup too, let the SEO plugin add it from its own content-type settings.

What mistakes should you avoid?

Avoid hidden answers, copied questions from other pages, two FAQ systems on one page, and markup that promises a rich result Google no longer shows.

  • Do not put answers in the markup that readers cannot see on the page.
  • Do not copy the same FAQ block onto every page of the site.
  • Do not run a Rank Math FAQ block and a Yoast FAQ block on the same page.
  • Do not use FAQPage for a forum thread where users submit their own answers.
  • Do not expect an expanded FAQ listing in Google Search after 7 May 2026.

Fix the visible page first when a mistake shows up, then fix the markup to match it. The markup is a label for the page, not a second version of it.

Frequently asked questions

Will FAQ schema bring back FAQ rich results in Google?

No. Google stopped showing FAQ rich results on 7 May 2026 and removed the documentation on 15 June 2026. Adding FAQPage markup will not restore the expanded listing, so add it only where a real set of visible questions helps readers and machines read the page.

Can I add FAQ schema to every page on my site?

No. Add it only to pages with a real set of questions and answers that readers can see. Copying the same FAQ block onto unrelated pages adds markup that does not describe those pages, and it wastes the time you could spend writing answers readers need.

Do I need Rank Math PRO or Yoast SEO Premium for FAQ schema?

No. Both plugins include FAQ blocks and FAQPage markup in their free versions. Rank Math keeps the reorder buttons for moving questions in its PRO version, and Yoast keeps some extra schema blocks in Premium, but the basic FAQ block is free in both.

Can I use FAQ schema with Article schema on the same page?

Yes. An SEO plugin can add more than one schema type to a page, and it will nest them so they stay valid. Keep FAQPage for the questions and answers, and let the plugin handle Article markup from the post itself instead of adding a second FAQ block.

How many questions should an FAQ section have?

Start with 4 to 6 real questions for most pages, because each answer stays short and readers can scan the list. Add more only when readers ask more, and keep every answer visible on the page next to its question.

What should I do if the validator reports an error?

Read the error line first, then open the block or script it points to. Most errors come from a missing question, a missing answer, or a comma out of place in hand-written JSON-LD. Fix the text, save the page, and run the validator again on the live URL.

Sources

  1. FAQPage - Schema.org Type Schema.org
  2. Latest Google Search Documentation Updates Google Search Central
  3. FAQ Schema - A Practical (and EASY) Guide Rank Math
  4. Structured data - Yoast SEO Features Yoast

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.

About the editors

WPLegible editors

Researched from the primary sources listed above and checked against our editorial rules. About the site · How we test