Your FAQ section is already written — and Google still cannot read it as structured Q&A. The fix takes about 60 seconds, costs nothing, and needs zero plugins. Here is how to add FAQ schema to WordPress without plugin — with a copy-paste template.
The short version: paste a small FAQPage JSON-LD block onto any page that already shows a visible FAQ, then check it with a validator. That is the whole job.
What Is FAQ Schema — and Why Bother in 2026?
FAQ schema is structured data that labels a page’s questions and answers in a machine-readable format, using the Schema.org FAQPage type written in JSON-LD.
For years, the payoff was the FAQ rich result: expandable Q&A dropdowns in Google search results. That payoff is gone — Google stopped showing FAQ rich results on May 7, 2026. But FAQPage remains valid Schema.org vocabulary, and AI answer tools use it to find answers.
The Rules That Keep Your FAQ Schema Safe
- The schema must match visible content. Every question and answer in your JSON-LD must appear word-for-word on the page — hidden FAQs violate Google’s guidelines.
- Use only one FAQPage block per page.
- Never duplicate it. If an SEO plugin already outputs FAQ schema on a page, do not add your own block.
How to Add FAQ Schema to WordPress Without Plugin: Method 1 — Custom HTML Block
The method most WordPress site owners should use: per-page, one minute, no theme files touched.
Step 1: Write your visible FAQ first
Add questions and answers with normal Gutenberg blocks — headings for questions, paragraphs for answers.
Step 2: Copy the JSON-LD template below
Replace the samples with your own wording.
Step 3: Add a Custom HTML block
Add a Custom HTML block at the bottom of the page and paste your JSON-LD into it, wrapped in <script type="application/ld+json"> tags.
Step 4: Update the page and validate it
Hit Update, then validate as shown below.
Copy-Paste FAQPage JSON-LD Template
Here is a complete FAQ schema WordPress template, using a small store’s shipping questions as samples.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "How long does shipping take?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Standard shipping takes 3 to 5 business days. Express arrives in 1 to 2."
}
},
{
"@type": "Question",
"name": "What is your return policy?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Return any unused item within 30 days for a full refund. Return shipping is free over $50."
}
},
{
"@type": "Question",
"name": "Do you ship internationally?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Yes, we ship to more than 40 countries. Delivery takes 7 to 14 business days."
}
}
]
}
</script>
Three details trip up beginners most:
- Commas go between items, never after the last one. A missing or extra comma is the most common validation error.
- Use straight quotes only. Curly “smart quotes” break JSON — retype them in the code editor.
Prefer not to hand-edit JSON? A free FAQ schema generator from technicalseo.com builds the same code from a form.
How to Add FAQ Schema to WordPress Without Plugin: Method 2 — functions.php
Method 2 is for the same FAQ schema on many pages without editing each one by hand. It uses wp_head in your child theme’s functions.php to inject the JSON-LD automatically — hook in with add_action, check a condition such as is_page('shipping'), and echo the JSON-LD.
A syntax error in functions.php can break your entire site, and a theme update wipes the code unless you use a child theme. Never edit functions.php in your parent theme — always back up the file first. Only use this method when the same FAQ appears on many pages.
Method 3: Use Your SEO Plugin’s FAQ Block (Rank Math)
If you already use Rank Math, its FAQ block outputs valid FAQPage JSON-LD automatically — no manual code needed.
The catch is the duplication rule: if Rank Math already generates the schema, adding your own block creates two FAQPage blocks. Check first: add your FAQ with the plugin’s FAQ block, publish, view the page source, and search for FAQPage. If it is there, you are done.
The 3 Methods Compared
| Method | Difficulty | Best For | Survives Theme Updates? |
|---|---|---|---|
| Custom HTML block | Easy | One page, beginners | Yes |
| functions.php + wp_head | Advanced | Same FAQ on many pages | Only in a child theme |
| Rank Math FAQ block | Easy | Sites already using Rank Math | Yes |
A Real-World Example: The Local Shop That Answers First
Picture a family-run store in Austin, Texas, selling leather wallets online. Its shipping page already answered the three questions every customer asks: delivery time, returns, and international shipping. The owner added the FAQ in plain text, then pasted a matching FAQPage JSON-LD block using Method 1. No new plugin, no redesign — and no magic ranking jump. What changed was discoverability: the store’s answers became structured data that search engines and AI tools could lift verbatim.
How to Validate Your FAQ Schema
- Open the Schema Markup Validator at validator.schema.org and paste your page URL or code — the best first check since Google retired FAQ support in the Rich Results Test.
- Run the page through Google’s Rich Results Test — its FAQ support ended in June 2026, so it will no longer preview a FAQ rich result.
- Check Google Search Console a week or two later for crawl errors or structured data warnings.
Key takeaway: a green validator result means your code is valid — it does not promise Google will display anything.
Frequently Asked Questions
Do I need a plugin for FAQ schema?
No — a Custom HTML block with JSON-LD, a functions.php snippet, or your SEO plugin’s FAQ block all work.
Where do I paste the JSON-LD code?
Paste it into a Custom HTML block at the bottom of the FAQ page, wrapped in <script type="application/ld+json"> tags.
How do I test FAQ schema?
Paste your page URL or code into the Schema Markup Validator at validator.schema.org — the primary check now.
Why isn’t my FAQ showing in search results?
Google stopped showing FAQ rich results entirely on May 7, 2026 — no site gets the old expandable dropdown anymore. Otherwise, check that your markup is valid and matches your visible content.
Can I add FAQ schema to a page without visible FAQs?
No — and you should not try. Google requires the questions and answers in your schema to match content visitors can read on the page. Schema for invisible FAQs violates Google’s guidelines.
The Bottom Line
Learning how to add FAQ schema to WordPress without plugin is a 60-second skill with a long shelf life. Write the FAQ your visitors can see, paste one matching FAQPage JSON-LD block with a Custom HTML block, validate it, and move on. Skip the extra plugin and duplicate markup — the real value is making your answers readable to every search engine and AI tool.
Your FAQ section already does the hard work of answering customers. Give it the label it deserves. Need help with the technical side? See our WordPress and SEO services or get in touch — and our SEO title tags guide pairs naturally with this one.
