Recipe: Branching quiz

“I want to explain each mistake differently.”

Every answer can lead to a different part of your video. A student who picks the rude phrase hears why it is rude; a student who drops the article hears about the article.

One question, four destinations

Each choice points at the sentence where its explanation begins. In the lesson that sentence is named by its ID.

Question Q1
  • Ac102“I want room.” The article is missing.
  • Bc047“I’d like to check in.” Why this is right.
  • Cc089“Give me room.” It is a command.
  • Dc121“Where room?” It is not a sentence.

Your video stays linear on YouTube

You upload one ordinary video. Shadowing Player creates the interactive route by jumping between sentences. Someone watching without the extension simply hears every explanation in a row.

  1. Intro
  2. Main lesson
  3. Quiz 1: context and question
  4. Correct explanation
  5. Wrong A explanation
  6. Wrong B explanation
  7. Wrong C explanation
  8. Quiz 2

The order of the explanation clips is up to you. If you would rather straight-through viewers did not hear them all, put them in a separate part of the video, such as the end.

Rules that keep branches safe

  • Branch to a sentence, not to a timestamp

    A choice names the sentence its explanation starts at. Sentences have clean, tested boundaries; an arbitrary frame-accurate time does not.

  • Start every target at a clean sentence boundary

    The student lands there straight from a paused question. Give it the same quiet before and after as any other sentence.

  • Make each explanation complete in itself

    It will be heard without the clip before or after it. Avoid “as I just said”.

  • Do not send every wrong answer to “Sorry, that’s wrong”

    Explaining why this particular answer is wrong is the whole point of branching.

Sentence IDs are the addresses of your branches

A branch says “go to sentence c102”. If you later renumber the sentences, c102 is a different clip and the branch plays the wrong explanation. Once a lesson is published, its sentence IDs stay as they are.

What it looks like in the lesson

For reference. Each choice has its text, whether it is correct, and the ID of the sentence to jump to.

{
  "id": "hotel-1",
  "triggerCueId": "q1",
  "prompt": "Which expression is most natural?",
  "choices": [
    { "id": "a", "text": "I want room.",          "correct": false, "targetCueId": "c102" },
    { "id": "b", "text": "I'd like to check in.", "correct": true,  "targetCueId": "c047" },
    { "id": "c", "text": "Give me room.",         "correct": false, "targetCueId": "c089" },
    { "id": "d", "text": "Where room?",           "correct": false, "targetCueId": "c121" }
  ]
}

Test every branch

  1. Play the question

    It pauses in the right place and the card does not cover what matters.

  2. Pick choice A

    The video goes to A’s own explanation, plays all of it and nothing more, and pauses.

  3. Go back and pick the next choice

    Repeat for B, C and D. A four-choice question is four passes.

  4. Run the whole quiz once

    From the first question to the last, without stopping.

← All teacher guides