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
- Read the visible FAQ on the page. Copy each question and its full answer text.
- Write one
Questionentry per item, withacceptedAnswerof typeAnswer. - Keep the text the same as the page. Simple HTML links in answers are allowed.
- 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