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

# Match

> Fill gaps from dropdown list

## Description

In **Match** questions, participant fills gaps in a sentence by selecting answers from dropdown lists. You can add wrong options (distractors) to increase difficulty.

## When to use

<Check>
  * Cause-effect relationships
  * Matching terms to definitions
  * Sentence completion with context
  * Questions with multiple gaps
  * Testing knowledge of connections
</Check>

## Creating a question

<Steps>
  <Step title="Select type">
    **"Add question"** → **"Match"**
  </Step>

  <Step title="Enter text with gaps">
    Mark gaps as `{0}`, `{1}`, `{2}` etc.:

    ```
    The largest planet in the Solar System is {0}, and the smallest is {1}.
    ```
  </Step>

  <Step title="Provide correct answers">
    For each gap enter the correct answer:

    * Gap {0}: **Jupiter**
    * Gap {1}: **Mercury**
  </Step>

  <Step title="Add distractors (optional)">
    Wrong options that will appear in lists:

    * Mars
    * Venus
    * Pluto
  </Step>

  <Step title="Set parameters">
    * **Time**: 30-60 seconds
    * **Points**: 1000-2000
  </Step>
</Steps>

## Participant view

Participant sees sentence with dropdown lists:

```
The largest planet in the Solar System is [▼ Select], and the smallest is [▼ Select].
```

After clicking dropdown:

```
[▼ Select     ]
   Jupiter
   Mars
   Mercury
   Venus
   Pluto
```

## Distractors

**Distractors** are wrong options added to dropdown lists.

| Without distractors  | With distractors |
| -------------------- | ---------------- |
| Only correct answers | Correct + wrong  |
| Easier               | Harder           |
| Fewer options        | More options     |

<Tip>
  Add 2-4 distractors for optimal difficulty. Distractors should be plausible but clearly wrong.
</Tip>

## Scoring

| Result           | Points |
| ---------------- | ------ |
| All gaps correct | 100%   |
| Some gaps wrong  | 0%     |

<Warning>
  Scoring is "all or nothing" - all gaps must be filled correctly.
</Warning>

## Examples

### Simple example

> **Question:** "The capital of {0} is {1}."
>
> * {0}: **Poland** | Distractors: Germany, France
> * {1}: **Warsaw** | Distractors: Berlin, Paris

### Complex example

> **Question:** "In {0} plants convert {1} and water into {2} and oxygen."
>
> * {0}: **photosynthesis**
> * {1}: **carbon dioxide**
> * {2}: **glucose**
>
> Distractors: respiration, nitrogen, protein, fats

## Best practices

### Number of gaps

<Tip>
  * **Minimum**: 1 gap
  * **Optimal**: 2-3 gaps
  * **Maximum**: 4 gaps (above becomes too complex)
</Tip>

### Distractors

* Should be plausible in context
* Should not be obvious answer to another gap
* 2-4 distractors per question

### Content

* Sentence should make sense when completed
* Context should help with selection
* Avoid overly long sentences

## Differences vs other types

| Match                           | Fill in blank      |
| ------------------------------- | ------------------ |
| Select from list                | Type answer        |
| Multiple gaps easy              | Single gap typical |
| Distractors increase difficulty | No distractors     |

| Match                      | Multiple choice     |
| -------------------------- | ------------------- |
| Gaps in sentence           | Separate answers    |
| Sentence context           | No context          |
| Relations between elements | Independent options |

## Next steps

<CardGroup cols={2}>
  <Card title="Open-ended" icon="comment" href="/en/questions/open-ended">
    Free text response
  </Card>

  <Card title="Ordering" icon="arrow-down-1-9" href="/en/questions/ordering">
    Element order
  </Card>
</CardGroup>