How to add FAQ schema to your page

FAQ schema is a FAQPage block of JSON-LD that marks up the questions and answers already visible on your page, so search engines can display them as rich results.

The golden rule: the Q&A in the schema must match the Q&A a visitor actually sees on the page. Marking up questions that aren't on the page is against Google's guidelines and can earn a manual action.

Why it matters

An FAQ rich result takes up more vertical space in the SERP and can answer follow-up questions before the user even clicks — which both raises visibility and pre-qualifies the click. It's also increasingly useful for AI answer engines, which lean on clean Q&A structure to extract and cite answers.

How to tell if this is you

Abby flags “FAQ Schema” when a page has FAQ-style content but no FAQPage markup. The fix is adding one JSON-LD block listing each on-page question and its answer.

The fix

If your page has FAQ content, add FAQPage schema: <script type="application/ld+json"> {"@context":"https://schema.org","@type":"FAQPage","mainEntity":[{"@type":"Question","name":"Q?","acceptedAnswer":{"@type":"Answer","text":"A."}}]} </script>

Before

<!-- FAQ visible on the page, but no FAQPage schema wrapping it -->

After

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [{
    "@type": "Question",
    "name": "Do you offer refunds?",
    "acceptedAnswer": {"@type": "Answer", "text": "Yes — within 30 days, no questions asked."}
  }]
}
</script>

Fix it on your platform

When this doesn’t apply

Only relevant if your page genuinely answers questions in a Q&A format. Marketing pages, feature lists, and documentation should not fake FAQ structure to capture rich results — Google penalizes spammy schema use.

FAQ