Technical SEO for AI Search · How to
How to add FAQ schema in WordPress: plugin or manual JSON-LD
Part of the guide Technical SEO for AI search: the 2026 checklist, in order
The easiest way to add FAQ schema in WordPress is the FAQ block from the SEO plugin you already run: Yoast SEO outputs FAQPage schema for its FAQ block by default, and Rank Math has its own FAQ block. If you want full control, paste FAQPage JSON-LD into a Custom HTML block. Then check the result with the Schema Markup Validator. Note that Google stopped showing FAQ rich results on 7 May 2026.
Before you start: what FAQ schema will and will not do now
FAQ schema labels the questions and answers on a page as structured data. Google no longer displays FAQ rich results for any site (deprecated from 7 May 2026, documentation removed 15 June 2026), so adding it will not change how your result looks in Google. It is still valid schema.org markup and costs little if your plugin generates it automatically.
If you are deciding whether it is worth doing at all, read what FAQ schema markup is and what it does now first. This page is the how-to. For where structured data fits among other technical tasks, see the technical SEO checklist for AI search.
Which method should you use?
Use the plugin you already have. Installing a second SEO plugin just for FAQ markup usually creates more problems (duplicate schema, conflicting meta tags) than it solves.
| Method | Best for | Skill needed | Keeps markup in sync with visible text |
|---|---|---|---|
| Yoast SEO FAQ block | Sites already on Yoast SEO | None | Yes, generated from the block |
| Rank Math FAQ block | Sites already on Rank Math | None | Yes, generated from the block |
| Other SEO plugins (All in One SEO, SEOPress) | Sites already on them | Low | Depends on the feature; check its docs |
| Manual JSON-LD in a Custom HTML block | One-off pages, no SEO plugin, full control | Basic JSON | No, you update both by hand |
| Theme or code snippet | Developers adding FAQ markup across a template | PHP | Yes, if built from the same fields |
Plugin details come from each plugin's WordPress.org page, checked 16 November 2026.
Method 1: Use your SEO plugin's FAQ block
This is the fastest route, and the markup is generated from the visible questions, so the two cannot drift apart.
With Yoast SEO (free or Premium):
- Open the post in the block editor.
- Click the + inserter and search for "FAQ". Choose the Yoast FAQ block.
- Type each question and answer into the block, using the block's button to add more questions.
- Update the post.
Yoast's WordPress.org page says the plugin "outputs schema for HowTo and FAQ blocks by default".
With Rank Math:
- In the block editor, search the inserter for "FAQ" and add the "FAQ by Rank Math" block.
- Enter your questions and answers.
- Update the post.
Rank Math's WordPress.org page lists FAQ schema among its supported schema types.
With All in One SEO or SEOPress: both plugin pages list FAQ among their schema types (All in One SEO says you can add FAQ schema "without touching code"; SEOPress lists FAQ in its JSON-LD schema editor). Whether the feature is in the free or paid version can change, so check the plugin's own documentation before you plan around it.
Method 2: Paste JSON-LD into a Custom HTML block
Use this when you have no SEO plugin, or when you need exact control over the markup on a single page.
- Write the visible FAQ on the page first, as normal headings and paragraphs.
- Add a Custom HTML block at the end of the post.
- Paste JSON-LD that repeats those exact questions and answers:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "How long does a boiler service take?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Most boiler services take 45 to 60 minutes."
}
},
{
"@type": "Question",
"name": "Do you service all boiler brands?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Yes, we service all major gas boiler brands."
}
}
]
}
</script>
- Update the post and view the page source to confirm the script is there.
Permission check: WordPress only lets users with the unfiltered_html capability post JavaScript and similar code. Administrators and editors have it on a single site; on multisite only Super Admins do. If your script disappears after saving, this is usually why.
The downside of this method: when someone edits the visible FAQ later, the JSON-LD does not change with it. Google's structured data guidelines say "Don't mark up content that is not visible to readers of the page", so stale markup is worse than none.
Method 3: Generate it in the theme (for developers)
If many pages share an FAQ layout, for example service pages built from custom fields, generate the markup in the template from the same fields that render the visible FAQ. Hook into wp_head, read the question and answer fields for the current post, build the array in PHP, and print it with wp_json_encode() inside a <script type="application/ld+json"> tag. Use a child theme or a site-specific plugin so theme updates do not wipe it.
Before you ship, make sure no SEO plugin is also outputting FAQPage for the same pages.
How to validate your FAQ schema
Validate every method the same way:
- Open the published page, view the source, and search for
FAQPage. Count how many times it appears. More than one FAQPage block on a page usually means two plugins, or a plugin plus manual code. - Paste the URL into the Schema Markup Validator (validator.schema.org). Fix any errors it reports, usually a missing comma or quote in hand written JSON.
- Compare the questions in the markup with the questions on the page, word for word.
Google's Rich Results Test was the usual tool for this, but since Google no longer offers an FAQ rich result, the Schema Markup Validator is the better check for FAQPage.
Common problems and fixes
| Problem | Likely cause | Fix |
|---|---|---|
| Two FAQPage blocks in the source | Two plugins, or plugin plus manual code | Keep one source; turn off the other |
| Script vanishes after saving | User lacks unfiltered_html |
Save as an administrator, or use a plugin block |
| Validator reports a parsing error | Hand written JSON with a trailing comma or curly quotes | Retype quotes as straight quotes, remove the trailing comma |
| Markup questions differ from the page | Visible FAQ edited, JSON-LD not | Regenerate from the visible FAQ, or switch to a block |
How Postbing handles FAQ schema on WordPress
If you publish with Postbing, its WordPress plugin (v1.4.0) writes each article with its FAQ section and JSON-LD, and fills in the meta fields for Yoast, Rank Math, All in One SEO or SEOPress, whichever you run. Every article includes FAQs and schema. Check the page source once after your first post to make sure your SEO plugin is not adding a second FAQPage block. More on the connection in our WordPress auto blogging guide, and the full list of connectors is on the integrations page.
FAQ
Does Yoast SEO free add FAQ schema?
Yes. Yoast's WordPress.org page says the plugin outputs schema for its FAQ block by default. Add the Yoast FAQ block in the block editor and the markup is generated from the questions you type.
Can I add FAQ schema in WordPress without a plugin?
Yes. Paste FAQPage JSON-LD inside a script tag in a Custom HTML block, as an administrator or editor on a single site. You then have to keep it in sync with the visible FAQ yourself.
Why is my FAQ schema not showing in Google?
Google stopped showing FAQ rich results for all sites from 7 May 2026. Valid FAQ markup will no longer produce an expandable FAQ in Google results.
How many FAQ questions should I mark up?
Mark up every question that is visible in the FAQ section, and nothing that is not. Three to six real questions is a sensible size for most articles.
Sources
- Google Search Central: Documentation updates: FAQ rich result deprecation and removal, accessed 16 November 2026
- Google Search Central: General structured data guidelines: do not mark up content that is not visible (page last updated 10 July 2026), accessed 16 November 2026
- WordPress.org: Yoast SEO plugin page: FAQ block schema output (version 28.8), accessed 16 November 2026
- WordPress.org: Rank Math SEO plugin page: FAQ schema and FAQ block, accessed 16 November 2026
- WordPress.org: All in One SEO plugin page: FAQ schema types, accessed 16 November 2026
- WordPress.org: SEOPress plugin page: JSON-LD editor with FAQ type, accessed 16 November 2026
- WordPress.org: Roles and capabilities: unfiltered_html capability by role, accessed 16 November 2026
- Schema.org: FAQPage: type definition, accessed 16 November 2026
Related reading
Last updated: November 16, 2026. Spotted an error? Email support@postbing.com and we will fix it. Editorial policy.
Try Postbing free
Postbing reads your site, plans a month of topics from what your customers search for, writes in your voice and publishes to WordPress, Shopify, Webflow or Ghost. Your first article is free.
Try Postbing freeNo card needed. No link exchanges, ever.