Schema

FAQPage schema

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/SKILL.md

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

{
  "@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
See all 30 skills