Quiz builder

Create a new quiz

Start from scratch, import a playlist, or generate questions from text.

Platform home

Create

Choose a creation method

Create a quiz

Import quiz from ZIP

Include one quiz JSON file and any images or audio files referenced by relative paths in its image_url or audio_url fields. Existing web and YouTube links also work. ZIP limit: 50 MB.

ZIP import example

Quiz JSON and media files

Place one JSON file in the ZIP. Its image_url and audio_url fields can point to files in the archive using relative paths. Remote image and YouTube links continue to work. The round field is optional.

sample-quiz.zip
├── quiz.json
└── resources/
    ├── picture.jpg
    └── song.mp3

Contents of quiz.json:

{
  "title": "Sample ZIP quiz",
  "description": "Questions with uploaded and linked media",
  "questions": [
    {
      "question": "What is in the picture?",
      "round": "Picture round",
      "correct_answer": "Cat",
      "incorrect_answers": ["Dog", "Fox"],
      "image_url": "resources/picture.jpg"
    },
    {
      "question": "Which artist performs this song?",
      "round": "Music round",
      "correct_answer": "Queen",
      "incorrect_answers": ["ABBA", "The Beatles"],
      "audio_url": "resources/song.mp3"
    },
    {
      "question": "Which band is linked?",
      "round": "Music round",
      "correct_answer": "Queen",
      "incorrect_answers": ["ABBA", "The Beatles"],
      "image_url": "https://example.com/band.jpg",
      "youtube_url": "https://www.youtube.com/watch?v=fJ9rUzIMcZQ"
    }
  ]
}

Import from YouTube Music

Create from text

Create quiz from prompt

When files are attached, each file is processed as a separate background import. JSON quiz files are imported directly when possible.

JSON import

Sample mixed quiz item

Use this shape for direct JSON imports. Extra metadata is accepted; round is optional, and media URLs are preserved on the question where they appear. 

{
  "title": "Sample mixed quiz",
  "description": "Regular, image, and audio questions in one file",
  "language": "sk",
  "version": 1,
  "scoring": {
    "mode": "standard"
  },
  "questions": [
    {
      "id": 1,
      "round": "Music round",
      "category": "Music",
      "type": "music",
      "difficulty": "easy",
      "question": "Play the linked song. Which artist performs it?",
      "correct_answer": "Queen",
      "incorrect_answers": ["ABBA", "The Beatles", "Pink Floyd"],
      "image_url": "https://example.com/image.jpg",
      "youtube_url": "https://music.youtube.com/watch?v=fJ9rUzIMcZQ",
      "audio_url": "https://www.youtube.com/watch?v=fJ9rUzIMcZQ",
      "explanation": "Bohemian Rhapsody is performed by Queen."
    }
  ],
  "supported_aliases": {
    "title": ["title", "name", "quiz_title"],
    "description": ["description", "summary", "subtitle"],
    "questions": ["questions", "items", "question_items", "quiz_items"],
    "question": ["question", "prompt", "text", "title"],
    "round": ["round"],
    "choices": ["options", "choices", "answers"],
    "correct_index": ["correct_index", "correct_answer_index", "answer_index"],
    "correct_answer": ["correct_answer", "answer", "correct", "correct_answers"],
    "incorrect_answers": ["incorrect_answers", "wrong_answers", "distractors"],
    "image_url": ["image_url", "image", "imageUrl"],
    "audio_url": ["audio_url", "youtube_url", "youtubeUrl"],
    "question_type": ["question_type", "type", "kind"],
    "explanation": ["explanation", "rationale", "note"]
  }
}