FAQPage Schema Markup
FAQPage markup describes a page of questions and their accepted answers. Google used it to show expandable FAQ results until May 7, 2026, when it stopped showing FAQ rich results. It's still valid schema.org markup.
Google Search Features
- FAQ — Retired (since May 7, 2026) Google no longer shows this rich result. FAQPage is still a valid schema.org type; the markup does no harm but earns no rich result.
When to Use FAQPage
Properties
| Property | Type | Status | Description |
|---|---|---|---|
| mainEntity | Question (array) | required | An array of Question objects, each with a name (the question) and acceptedAnswer. |
JSON-LD Examples
Product FAQ
An FAQ section for a product page.
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "What is your return policy?",
"acceptedAnswer": {
"@type": "Answer",
"text": "We offer a 30-day money-back guarantee on all products. Items must be returned in original packaging."
}
},
{
"@type": "Question",
"name": "How long does shipping take?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Standard shipping takes 5-7 business days. Express shipping takes 2-3 business days. Free shipping on orders over $50."
}
},
{
"@type": "Question",
"name": "Do you ship internationally?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Yes, we ship to over 50 countries. International shipping takes 10-15 business days."
}
}
]
}Common Mistakes
Not using @type: 'Question' and @type: 'Answer' — each entry in mainEntity needs both.
Using FAQPage for user-generated Q&A forums — FAQPage is only for editorially curated FAQ content.
Adding FAQ markup to pages where the questions aren't actually visible on the page.
Complete Guide to FAQPage Schema Markup
FAQPage schema markup describes the questions and answers on a page. Google no longer shows FAQ rich results: it announced in May 2026 that the feature would stop appearing in Google Search from May 7, 2026, after limiting it to well-known government and health websites in 2023. The markup is still valid schema.org, but it no longer changes how your page looks in Google Search.
Implementation is straightforward: wrap your questions and answers in a FAQPage object with a mainEntity array. Each item must be a Question object with a name (the question text) and an acceptedAnswer containing an Answer object with the text.
When Google still showed FAQ rich results, its guidelines limited FAQPage to pages where the site itself provides the questions and answers. User-generated Q&A forums should use QAPage instead. The FAQ content must be visible on the page — you cannot mark up hidden content.
Related Types
Ready to Create FAQPage Markup?
Use our free generator to create valid FAQPage JSON-LD markup with a visual form. No coding required.
Open Generator