> ## Documentation Index
> Fetch the complete documentation index at: https://help.edzo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Multiple Choice Question Block

> Learn how to use Multiple Choice Question blocks to create selection-based assessments.

The **Multiple Choice Question** block lets learners select one or more correct answers from a set of options. It's one of the most versatile question types, suitable for quick knowledge checks, quizzes, and formal assessments.

Options can include text, images, or both, making this block ideal for visual learners and a wide range of subjects.

<Info>
  Multiple Choice Questions support single-select and multi-select modes.
</Info>

## When to use Multiple Choice Questions

Multiple choice questions work well for:

* Quick knowledge checks and recall questions
* Identifying correct answers from a set of options
* Visual identification tasks using images
* Assessments where there may be one or multiple correct answers
* Randomised question order for test integrity

## Settings

### Display settings

<ParamField path="Layout" default="list" type="select">
  How the options are arranged: **list** (vertical) or **grid** (rows and columns).
</ParamField>

<ParamField path="Grid columns" default="2" type="slider">
  The number of columns when using grid layout (1–4). Only visible when layout is set to grid.
</ParamField>

<ParamField path="Image fit" default="cover" type="select">
  How images are displayed within option cards: **cover** (fills the space, may crop) or **contain** (shows entire image).
</ParamField>

<ParamField path="Image size" default="md" type="select">
  The size of images in options: **small**, **medium**, or **large**.
</ParamField>

<ParamField path="Image padding" default="none" type="select">
  Padding around images in option cards.
</ParamField>

### Answer settings

<ParamField path="Multi-Select" default="false" type="switch">
  When enabled, learners can select multiple options. When disabled, only one option can be selected (radio button behavior).
</ParamField>

<ParamField path="Correct Count" default="all" type="select">
  Determines how many correct answers must be selected:

  * **All**: The learner must select all correct options to earn marks.
  * **One**: Selecting any one correct option is sufficient.
</ParamField>

<ParamField path="Random Order" default="false" type="switch">
  When enabled, the order of options is randomised each time the question is presented. Useful for preventing answer memorisation.
</ParamField>

## Answer and Marking

To set up your multiple choice question:

1. Add your options using the items editor
2. Each option can have text, an image, or both
3. Mark one or more options as correct using the checkbox next to each item
4. If multi-select is enabled, mark all correct options

The question is marked correct when the learner's selection matches the correct answer(s) based on the **Correct Count** setting.

## Response settings

<ParamField path="Response requirement" default="Correct" type="select">
  Determines when the question is considered complete:

  * **Correct**: The learner must answer correctly to proceed.
  * **Answered**: Any response is accepted; correctness isn't required.
  * **Optional**: The learner can skip the question entirely.
</ParamField>

<ParamField path="Max responses" default="0" type="slider">
  The number of attempts the learner can make before the question is locked (0–3). Set to **0** for unlimited attempts.
</ParamField>

<ParamField path="XP points" default="5" type="slider">
  The experience points awarded for answering the question correctly (0–10).
</ParamField>

## Tips for teachers and parents

**Best practices:**

* Write clear, unambiguous options that are distinct from each other
* Avoid "all of the above" or "none of the above" options. They can be confusing
* Use **Random Order** for assessments to prevent answer sharing
* Keep the number of options manageable (3–5 is ideal for most questions)
* Use images to make questions more engaging and accessible for visual learners
* For multi-select questions, consider indicating how many correct answers exist (e.g., "Select all that apply" or "Select two")
