> For the complete documentation index, see [llms.txt](https://mindengage.gitbook.io/mindengage-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mindengage.gitbook.io/mindengage-docs/quiz-builder.md).

# Quiz Builder

The Adaptive Quiz Builder instantly transforms highlighted lesson text into Bloom-aligned formative questions—no coding required.

The Quiz Builder is a point-and-click wizard that lets you generate self-scoring quizzes in seconds. Highlight any passage in **Lesson Preview**, give the quiz a clear name, pick a cognitive tier-aligned format (True/False, Single-Select, Multi-Select, Numeric, Short Answer, or Confidence-Based MCQ), set the number of questions, and click **Create**. The builder auto-generates clean HTML with built-in scoring logic, Bloom’s-taxonomy tagging, and a floating **Viz Card** you can drag into place or refine later through the Visual Editing flow—making it effortless to weave low-stakes assessment directly into your content.

> ✏️ **Quick start:** Highlight any sentence in *Lesson Preview* to open the **Quiz** dialog.

### Workflow

1. Select a **Course** and **Lesson**.
2. Highlight text using mouse from the lesson → **Quiz** modal appears.
3. You may edit the selected content or describe the quiz topic.

   <figure><img src="https://1630048059-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz5vwxN0ZYDFxp9SGEstf%2Fuploads%2F7RLpEUikaZcdzIbHyx2R%2Fbackground-checkers(4).png?alt=media&amp;token=3cdaaaec-5c93-4e3a-9288-247544e9ff55" alt=""><figcaption></figcaption></figure>
4. Fill in: **Quiz Name**, **Type** (MCQ, Short Answer etc), **Number of Questions**. Details about available quiz types in the following table.
5. Press **Create** – a floating **Viz Card** appears. See the [Visual Editing operation](/mindengage-docs/common-dialog-boxes/visual-editing.md) for editing the quiz by re-prompting and placing in the document.

#### &#x20;Quiz Type

The drop-down groups available formats by the **Bloom’s-taxonomy level** they primarily assess.

| Cognitive Tier            | Quiz Type                                | When to Use                                                  | Scoring Model                                                    |
| ------------------------- | ---------------------------------------- | ------------------------------------------------------------ | ---------------------------------------------------------------- |
| **Remember / Understand** | **True / False**                         | Quick breadth check, binary facts.                           | +1 correct / 0 wrong.                                            |
|                           | **Single-Select (Choose one)**           | Classic MCQ with one right answer and plausible distractors. | +1 correct / 0 wrong.                                            |
| **Apply / Analyze**       | **Multi-Select (Choose all that apply)** | Nuanced concepts with multiple valid facets.                 | Full credit only for exact set (\<span>or\</span> proportional). |
|                           | **Numeric**                              | Computation or unit-based answers (physics, chem, stats).    | Within tolerance ⇒ +1.                                           |
| **Evaluate / Create**     | **Short Answer**                         | Learner must articulate reasoning in 1–2 sentences.          | Auto-match key points; partial credit possible.                  |
|                           | **Confidence-Based MCQ**                 | Encourage metacognition; learners wager certainty.           | Differential payoff table (e.g., +3/–3).                         |

Drag & drop or press **Place Visualization** to embed.

<figure><img src="https://1630048059-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz5vwxN0ZYDFxp9SGEstf%2Fuploads%2FzNOdkA0BZwLUSMwJ4l7w%2Fimage.png?alt=media&amp;token=876a93ee-df25-476a-887b-81bbd7463410" alt="" width="563"><figcaption><p>Screenshot of a generated quiz</p></figcaption></figure>

> 💡 **Tip:** Keep formative quizzes short (3–5 questions). For longer assessments, see **Exam Builder**.