Google FAQPage Structured Data Guide: Schema.org, JSON-LD & Rich Snippets
Structured data markup provides search engines with explicit semantic clues about the meaning of your content. By wrapping frequently asked questions in Schema.org FAQPage JSON-LD code, your pages become eligible for interactive rich snippet cards and voice assistant search answers.
Google’s Official FAQPage Guidelines
To qualify for rich result features, Google enforces strict content and markup rules:
| Requirement | Compliant Practice | Policy Violation |
|---|---|---|
| Visual Visibility | Questions and answers MUST be visibly displayed on the page to human users. | Hiding questions in hidden accordions or CSS display:none just for bots. |
| Content Authority | Written directly by the site publisher or editorial team. | Allowing unvetted user-generated forum replies as accepted answers. |
| Commercial Promotion | Answers provide genuine educational assistance. | Using FAQ answers purely as advertising links or repetitive promotional slogans. |
| Format | JSON-LD inside <script type="application/ld+json">. | Using deprecated microformats or unescaped quote syntax. |
Standard FAQPage JSON-LD Code Structure
The canonical structured data script block follows this standard schema:
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "How long does shipping take?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Standard shipping takes 3 to 5 business days."
}
}
]
}Ready to try it?
Open the FAQ Schema Generator and follow the steps above.
Related tools and guides
Frequently asked questions
Where should I paste the FAQ schema script in Next.js?
In Next.js App Router, render a <script type="application/ld+json" dangerouslySetInnerHTML={{ __html: JSON.stringify(schema) }} /> directly in your page component.
Will adding FAQ schema guarantee Google rich snippets?
No. Google states that structured data enables eligibility for rich results, but display is at Google’s discretion based on search intent and site quality.