Skip to Content
📧 Join the Teacharium waitlist to get access. 
User DocumentationItemsMatching

Matching

Ask learners to drag answers to matching question stems. Matching items are ideal for connecting related concepts, vocabulary, definitions, or any paired relationships.

Behavior

  • Drag and drop matching – Learners drag answer choices from a pool to match question stems
  • Distractors – Include extra answer choices that don’t match any question
  • Visual feedback – Shows correct/incorrect matches when checked
  • Check answer workflow – Optionally show a “Check Answers” button to verify all matches
  • Variable tracking – Tracks matches and correctness in variables

Inputs

Question & Answer Pairs (array)

  • List of matching pairs (question stems and their correct answers)
  • Each pair has:
    • Question ID: Auto-generated unique identifier for the question
    • Question Stem: Rich content (text, images, etc.) displayed as the question
    • Answer ID: Auto-generated unique identifier for the answer
    • Correct Answer: Rich content (text, images, etc.) that matches this question
  • Default: 2 sample pairs provided

Distractors (array)

  • Extra answer choices that don’t match any question
  • Adds challenge by providing incorrect options
  • Each distractor has:
    • Distractor ID: Auto-generated unique identifier
    • Distractor Content: Rich content (text, images, etc.) displayed as an answer option
  • Optional: No distractors by default

Show Check Answer Button (Yes/No)

  • Whether to display a “Check Answers” button
  • If “Yes”, learners click the button to verify all matches
  • If “No”, matching is evaluated automatically (useful with Logic Quiz widget)
  • Default: Yes

Check Button Text (text)

  • Custom text for the check answer button
  • Default: “Check Answers”

Correct Feedback (text)

  • Message shown when all matches are correct
  • Default: “Great job! Every match is correct.”

Incorrect Feedback (text)

  • Message shown when some matches are incorrect
  • Default: “Not quite right. Review each match and try again.”

Use cases

  • Vocabulary matching – Match terms with definitions
  • Concept pairing – Connect related ideas or concepts
  • Category matching – Match items to their categories
  • Relationship mapping – Connect causes and effects, problems and solutions, etc.
Last updated on
Items overviewMatrix Choice