> ## 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.

# Match Up Question Block

> Learn how to use Match Up Question blocks to create interactive matching pair activities.

The **Match Up Question** block creates interactive matching activities where learners draw lines to connect items in two columns. Each item on the left has a correct match on the right.

Perfect for vocabulary, definitions, conversions, and any content where learners need to identify relationships between pairs.

<Info>
  Match Up Questions support both text and image items, so you can create visual matching activities too.
</Info>

## When to use Match Up Questions

Match Up Questions work well for:

* Matching vocabulary words to definitions
* Connecting images to labels or descriptions
* Pairing equivalent values (fractions, decimals, percentages)
* Linking causes to effects or events to dates
* Any activity where learners identify correct pairs

## Settings

### Pairs

Set up the matching pairs by adding items to the left and right columns. Each pair consists of:

* A **left item** with a text label and optional image
* A **right item** with a text label and optional image

You can add between 2 and 12 pairs.

### Display settings

<ParamField path="Shuffle sides" default="true" type="switch">
  When enabled, the right-side items are shuffled so they don't appear in the same order as their matches. This is usually what you want to make the activity meaningful.
</ParamField>

<ParamField path="Draw style" default="Line" type="select">
  The style of line drawn between matched pairs:

  * **Line**: Straight lines between items
  * **Curve**: Curved lines between items
</ParamField>

## Answer and marking

The correct answer is determined by the pairs you set up. Each left item must be matched to its corresponding right item. The question is marked correct when all pairs are matched correctly.

## 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:**

* Keep the number of pairs manageable for younger learners (3 to 4 pairs)
* Use images on one side and text on the other for vocabulary building
* Make sure the matches are clear and unambiguous
* For older learners, increase the number of pairs to add challenge
* Use with topics like math facts, science terms, historical events, or spelling words

## Related blocks

* [Sort Question](/creating/resources/question-blocks/sort-question): For sorting items into categories
* [Order Question](/creating/resources/question-blocks/order-question): For arranging items in a specific sequence
