Question schema
A single question, nested inside a FAQPage or a QAPage, paired with its accepted answer.
Where to use it
Nested inside FAQPage or QAPage.
A complete example
Valid as written, with every required property and the recommended ones that carry real information.
{
"@context": "https://schema.org",
"@type": "Question",
"name": "Acme Reference",
"acceptedAnswer": {
"@type": "Answer",
"text": "A self-contained answer that restates its own subject."
},
"suggestedAnswer": {
"@type": "Answer",
"text": "An alternative answer."
},
"answerCount": 1,
"upvoteCount": 12
}Generate a Question node with your own values in the schema generator, and lint what your page actually ships with the schema validator.
Properties
| Property | Status |
|---|---|
name | Required |
acceptedAnswer | Required |
suggestedAnswer | Recommended |
answerCount | Recommended |
upvoteCount | Recommended |
The three mistakes this type attracts
- 01Answer text that differs from the visible answer.
- 02Omitting acceptedAnswer, which leaves the question unanswered.
- 03HTML in the answer text that the page does not render.
Related types
Where this appears in the playbook
- Structured data: what each type is for and which ones earned their place.
- The schema graph: composing types into one graph with stable identifiers.
- One JSON-LD script per page, holding one @graph
- Stable @id anchors that cross-reference rather than duplicate
- Optional fields are omitted, never emitted as empty strings
- Does schema markup work? What 42 types on one site actually did: which of these types measurably did anything in production.
Questions
What is the Question schema type for?
A single question, nested inside a FAQPage or a QAPage, paired with its accepted answer. Use it on: nested inside FAQPage or QAPage.
Which Question properties are required?
Question requires 2 properties: name, acceptedAnswer. It also recommends 3: suggestedAnswer, answerCount, upvoteCount.
Does Question produce a rich result?
Question does not produce a Google rich result. It is still worth shipping, because its value is entity resolution and answer extraction rather than search result presentation.
What is the most common Question mistake?
The most common Question mistake is: Answer text that differs from the visible answer.