Info severity

How do I add FAQPage schema so AI assistants can extract my Q&As?

If a page has question-style headings but no FAQPage JSON-LD, AI assistants and search engines must guess the question-answer structure. Add a single JSON-LD block with @type FAQPage listing every visible question and its complete answer, keep it in sync with the on-page text, then validate it.

Agents affected

ChatGPTClaudePerplexityGeminiGoogle AI Overviews

How to tell you have this problem

Our scanner reports "missing_faq_schema" — the page has 3+ headings ending in "?" but no FAQPage JSON-LD.
AI answers paraphrase your FAQs loosely (or attribute them to competitors) instead of quoting your exact answers.
Rich FAQ results never appear for your pages in search.

How to fix it

Add one FAQPage JSON-LD block to the page <head> or body. Each mainEntity item is one visible Q&A pair — the text must match what users see on the page:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "How long does shipping take?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Orders ship within 24 hours and arrive in 3-5 business days."
      }
    },
    {
      "@type": "Question",
      "name": "Can I return a product?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Yes — returns are free within 30 days of delivery."
      }
    }
  ]
}
</script>

Include the full answer text in acceptedAnswer.text, not a teaser — AI assistants lift this text verbatim into answers.
Validate the block at validator.schema.org (paste the URL or the JSON), fix any parse errors, then re-scan.

FAQ

Does FAQ schema still matter now that Google limited FAQ rich results?

For rich snippets Google restricted FAQ display to authoritative government and health sites in 2023. But FAQPage JSON-LD is machine-readable structure that AI assistants can parse regardless of Google’s snippet policy — it makes your exact Q&A text trivially extractable, which is the goal for AI visibility.

Can I put FAQ schema on a page without visible FAQs?

No. Structured data must describe content that is actually on the page. Invisible-only Q&As violate Google’s structured data guidelines and can earn a manual action. Add the visible FAQ section first, then mark it up.

One big FAQPage block or one block per question?

One FAQPage block per page, with all questions in the mainEntity array. Multiple FAQPage entities on a single page are non-standard and some parsers only read the first.

Not sure if your site has this issue?

Run a free scan — we test this check (and 60+ others) against your live site and give you the exact paste-ready fix. No signup needed.