What You Need Before Starting
You need an actual FAQ section on your page โ the JSON-LD must match visible content. Do not add FAQ schema to pages without a visible FAQ section.
Generate your FAQ JSON-LD
Use the FAQ Schema Generator to create your FAQPage JSON-LD. Enter your page URL, add your questions and answers (minimum 2, each answer at least 40 characters), and click Generate.
Copy the JSON-LD code
Click the Copy button to copy the JSON-LD code. It will look like this:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [ ... ]
}
</script>
Add to your page's <head> section
Open your page's HTML source and paste the script right before the closing </head> tag. If you use a CMS, look for a "Custom Code" or "Head" injection setting.
WordPress: Use a plugin like WPCode or your theme's custom head field.
Shopify: Go to Online Store > Themes > Actions > Edit code > Add a custom liquid block in the head.
Webflow: Use Project Settings > Custom Code > Head code.
Verify the JSON-LD matches your page content
The questions and answers in your JSON-LD must match exactly what users see on your page. If you update your FAQ content, regenerate and replace the JSON-LD.
Validate and publish
Save your page and test it loads without errors. Use the FAQ Schema Generator to re-validate any time you update your FAQ content.
Implementation Checklist
Use this checklist before publishing your FAQ schema:
Common Mistakes to Avoid
- Adding FAQ schema to pages without FAQ content โ The JSON-LD must correspond to visible content. Invisible schema is considered spam.
- Using generic placeholder content โ Replace all template text with your actual FAQ. Generic or obviously fake content is ignored by AI systems.
- Making ranking or citation promises in FAQ answers โ Claims like "will always rank #1" or "guaranteed AI citation" are red flags. Keep answers factual.
- Placing JSON-LD in the body instead of head โ FAQPage JSON-LD belongs in
<head>like all structured data. - Forgetting to update schema when FAQ content changes โ Keep the JSON-LD in sync with your visible FAQ content.
Frequently Asked Questions
Can I add FAQ schema to a page built with Wix or Squarespace?
Yes. Both Wix and Squarespace support custom code injection through their settings. In Wix, go to Settings > Tracking & Analytics > Custom Header Code. In Squarespace, use Settings > Advanced > Code Injection. Paste the JSON-LD script there.
Do I need to add FAQ schema to every page?
No. Add FAQPage JSON-LD only to pages that contain a visible FAQ section. Pages without FAQ content should not include FAQPage schema.
Can I use multiple FAQ sections on one page?
Yes. If your page has multiple distinct FAQ topics, you can include multiple FAQPage JSON-LD blocks โ one per topic. Each should correspond to a visible FAQ section on the page.
Does FAQ schema help with AI search?
FAQPage JSON-LD makes FAQ content machine-readable, which may help AI systems parse and understand your Q&A content. There is no guarantee of improved AI visibility or citations. This is one of many content signals.