Quiz (Education Q&A) Schema Validation API

Quiz schema markup enables education Q&A rich results in Google Search — surfacing educational quiz questions and flashcard-style content for students. Valid Quiz structured data marks up practice questions, assessments, and study materials. Each Quiz contains Question items with correct answers and distractors.

Required Properties

Property	Type	Description
`name`rich result	string	The name or title of the quiz.
`hasPart`rich result	Question array	The quiz questions. Each Question needs text and acceptedAnswer with text.

Recommended Properties

Missing recommended properties generate warnings. They won't block validation, but rich result-tagged properties are needed for full Google rich result eligibility.

Property	Type	Description
`about`	Thing	The subject or topic of the quiz.
`educationalLevel`	string	Grade level or educational level (e.g. 'Grade 10', 'AP Chemistry').
`educationalAlignment`	AlignmentObject	Alignment with educational frameworks or standards.
`description`	string	A description of the quiz.

Rich Result Eligibility

Rich result type: Education Q&A rich result for students

Requirements: Required: name and hasPart (array of Question items with text and acceptedAnswer).

Example valid Quiz JSON-LD

{
  "@context": "https://schema.org",
  "@type": "Quiz",
  "name": "JSON-LD and Schema.org Basics Quiz",
  "educationalLevel": "Intermediate",
  "about": {
    "@type": "Thing",
    "name": "Structured Data"
  },
  "hasPart": [
    {
      "@type": "Question",
      "text": "What does JSON-LD stand for?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "JavaScript Object Notation for Linked Data"
      },
      "suggestedAnswer": [
        {
          "@type": "Answer",
          "text": "JavaScript Object Notation for Linked Documents"
        },
        {
          "@type": "Answer",
          "text": "JSON Language Definition"
        }
      ]
    },
    {
      "@type": "Question",
      "text": "Which property is required for all Schema.org types?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "@type"
      },
      "suggestedAnswer": [
        {
          "@type": "Answer",
          "text": "@context"
        },
        {
          "@type": "Answer",
          "text": "name"
        }
      ]
    }
  ]
}

Validate via API

Validate this schema against Google's requirements in one API call:

curl "https://schemacheck.dev/api/v1/validate" \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonld":{"@context":"https://schema.org","@type":"Quiz","name":"JSON-LD and Schema.org Basics Quiz","educationalLevel":"Intermediate","about":{"@type":"Thing","name":"Structured Data"},"hasPart":[{"@type":"Question","text":"What does JSON-LD stand for?","acceptedAnswer":{"@type":"Answer","text":"JavaScript Object Notation for Linked Data"},"suggestedAnswer":[{"@type":"Answer","text":"JavaScript Object Notation for Linked Documents"},{"@type":"Answer","text":"JSON Language Definition"}]},{"@type":"Question","text":"Which property is required for all Schema.org types?","acceptedAnswer":{"@type":"Answer","text":"@type"},"suggestedAnswer":[{"@type":"Answer","text":"@context"},{"@type":"Answer","text":"name"}]}]}}'

Official Documentation

Google Structured Data: Quiz →

Validate your Quiz schema now

100 free validations/month. No credit card required.

Get your free API key ← All schema types