Matching

1. What the learner does and sees

Shows two sets of elements so that the learner can build the correct relationships between them.

Use it for terms and definitions, countries and capitals, related concepts, or any matching exercise.

2. Create in Studio

This is the normal path if you are creating the course visually. You don't need to write JSON or execute commands.

1. Abre Studio.Use the hosted editor or the Studio you have integrated into your project.
2. Add the activity.In Add content, abre Games and choose Matching.
3. Edita visualmente.Change statements, responses, and options with editor controls. The JSON remains as an advanced view, not a requirement for use.
4. Check the learner View.Play the activity before downloading or saving the course.

3. Content requirements

• In Studio it is created as a question of type Matching.
• The activity requires embedded solutions and at least three complete pairs.
• The relationships must be distinguishable: duplicate texts that make the correspondence ambiguous invalidate this presentation.

4. Valid data example

This block shows a complete and valid questionnaire for this presentation. It is used to understand the format or to walk through the CLI; If you use Studio, the editor generates this structure for you.

{
  "schema": "https://p2lrn.org/schema/native-questionnaire/0.4.0",
  "version": "0.4.0",
  "title": "Match countries and capitals",
  "language": "en",
  "grading": {
    "mode": "embedded-key"
  },
  "questions": [
    {
      "id": "q1",
      "type": "matching",
      "prompt": "Match each country with its capital",
      "points": 3,
      "left": [
        {
          "id": "l1",
          "text": "Spain"
        },
        {
          "id": "l2",
          "text": "France"
        },
        {
          "id": "l3",
          "text": "Italy"
        }
      ],
      "right": [
        {
          "id": "r1",
          "text": "Madrid"
        },
        {
          "id": "r2",
          "text": "Paris"
        },
        {
          "id": "r3",
          "text": "Rome"
        }
      ],
      "solution": {
        "pairs": [
          {
            "left": "l1",
            "right": "r1"
          },
          {
            "left": "l2",
            "right": "r2"
          },
          {
            "left": "l3",
            "right": "r3"
          }
        ]
      }
    }
  ]
}

5. How to read the example

left and right define the two columns. solution.pairs match the correct identifiers.

6. Create by CLI — advanced alternative

Use this tour only if you are generating the course by code. Requires Toolkit installed via NPM. The file quiz.json It must contain a valid questionnaire like the example above.

p2lrn-create add-questionnaire ./workspace ./quiz.json \
  --key quiz \
  --title "Matching" \
  --renderer "https://p2lrn.org/renderer/questionnaire/matching"

p2lrn-create build ./workspace ./course.p2lrn --strict-profiles

--renderer Select the preferred presentation. It does not create a second copy of the questions: the content remains the native questionnaire.

7. Technical presentation identifier

Typically Studio sets this up for you. You only need this identifier when you select presentation from code, CLI, or the viewer.

8. Interaction and accessibility

The elements are buttons and the relationship can be completed by selection, without relying exclusively on dragging.

9. Completion and scoring

Each resolved relationship updates the state of the question. When all pairs are completed, the activity can end and score is reported.

To save the result on your platform, see Events and Host Adapter.

10. Try the example

Open the demo package in the real viewer and check the interaction before integrating it.