Exercise block
The Exercise block lets you configure interactive assessments. You set the exercise type, write the task prompt, and define questions with correct and incorrect answers.
Exercise types
| Type | Best for |
|---|---|
multiple_choice | Questions with distinct right and wrong answers |
true_false | Factual recall and misconception correction |
sort_list | Sequences, steps, and ordered processes |
sort_words | Sentence reconstruction and grammar |
fill_blanks | Contextual vocabulary with typed input |
fill_blanks_options | Gap-fill with dropdown options |
drag_words | Gap-fill with draggable tokens |
crossword | Vocabulary practice in puzzle format |
Multiple choice
| Field | Type | Notes |
|---|---|---|
type | "multiple_choice" | Exercise discriminator |
task | string | Instruction shown above all questions |
questions | array | One or more questions |
Each question has task, multiple, and answers. Each answer has value, correct, and score.
True/false
| Field | Type | Notes |
|---|---|---|
type | "true_false" | Exercise discriminator |
task | string | Instruction above statements |
questions | array | Statement list |
Each question includes exactly two answers: one "true" and one "false".
Sort list
| Field | Type | Notes |
|---|---|---|
type | "sort_list" | Exercise discriminator |
task | string | Instruction |
questions | array | Exactly one question |
The single question contains answers in the correct order. Correctness is encoded by priority values.
Sort words
Same structure as Sort list, but intended for horizontal word ordering (type: "sort_words").
Fill blanks
| Field | Type | Notes |
|---|---|---|
type | "fill_blanks" | Exercise discriminator |
task | string | Optional instruction |
body | string | HTML text with placeholders like [#1#] |
questions | array | One entry per placeholder |
Each question maps to a placeholder and has an answers array where the first answer is usually the correct one.
Fill blanks with options
Same structure as Fill blanks with type: "fill_blanks_options" and dropdown input.
Drag words
Same structure as Fill blanks with type: "drag_words" and drag-and-drop tokens.
Crossword
| Field | Type | Notes |
|---|---|---|
type | "crossword" | Exercise discriminator |
task | string | Optional instruction |
questions | array | Clue-answer pairs |
Each question has one answer. Crossword answers must be uppercase single words without spaces or punctuation.
Tips
- Choose the type first. Data structure and UX depend on it.
- Keep tasks explicit. Clear instructions improve completion rates.
- Validate placeholder mapping. In fill-blanks variants, placeholders and question order must align.