---
name: faqpage-schema
description: Add FAQPage JSON-LD that matches visible questions and answers on a page, and set the right expectations for rich results. Use when a page has an FAQ section without markup, or when a user asks for FAQ schema.
---

# FAQPage schema

## Facts to use
- Google stopped showing FAQ rich results in Google Search on May 7, 2026, for all sites. Before that, from August 2023, only well-known government and health sites got them. Add FAQPage markup only to describe the page for other tools. Do not expect a rich result.
- The markup must match questions and answers that are visible on the page.
- Use FAQPage for a list of questions written by the site. Use QAPage for a page where users submit answers to one question.
- The visible FAQ block still helps people and AI tools that read the page (see faq-blocks-for-ai-answers).

## Workflow
1. Read the visible FAQ on the page. Copy each question and its full answer text.
2. Write one `Question` entry per item, with `acceptedAnswer` of type `Answer`.
3. Keep the text the same as the page. Simple HTML links in answers are allowed.
4. Put the block in the raw HTML. Validate with the Schema Markup Validator.

## Template
```json
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Do you have a free plan?",
      "acceptedAnswer": { "@type": "Answer", "text": "Yes. The free plan includes 3 scans a month." }
    }
  ]
}
```

## Checks
- [ ] Every question in the markup is visible on the page.
- [ ] The same FAQ is not marked up on many pages.

## Output
The JSON-LD block and a note that Google no longer shows FAQ rich results.

## Sources
- Google: FAQ (FAQPage) structured data (deprecated). https://developers.google.com/search/docs/appearance/structured-data/faqpage
