In This Article

What Is the Matching Element?

The matching element is an interactive knowledge check not unlike a jigsaw puzzle. When learners encounter a matching element in a lesson, they'll see cards in two columns from which to make logical pairs.

A thumbnail image of the matching element as a learner would encounter it within a Lessonly lesson.

For example, one column could list several terms while the other supplies definitions of those terms. Pairing each term with its correct definition will solve the quiz. Of course, this is just an example. You can customize the matching element however you like!

Learners can rearrange matches and check their answers until they get it right. The matching element is not graded, so learners can practice without penalty. Moreover, the matching element is interactive. Its drag-and-drop motion cues learner attention, increasing engagement and promoting knowledge retention.

Sample use cases include:

  • Vocabulary drilling: match terms of art to their definitions

  • Objection handling: match frequently encountered prospect objections to effective solutions and counterarguments

  • Product training: match a given feature to its purpose or function

Where is the Matching Element Located?

Navigate to the lesson builder, then open the Add Element menu. Hover over Knowledge Check, then select Matching from the list.

How to Create a Matching Element

Give your matching quiz a prompt. This prompt should clearly identify the concepts on which learners are being tested and give them instructions on how to complete the activity. Next, add between 2 and 10 pairs for learners to match. Click Add Pair at the bottom of the element to add a new row.

πŸ’‘ Important Note: Cards are limited to 90 characters.

Consider including a text element above your matching element. This will enable you to supply additional context or instructions.

The items in each column will be randomly sorted whenever the matching element is previewed and when learners encounter it in a lesson.

πŸ’‘ Tip: Limiting your pairs to a maximum of five items will prevent learners from being overwhelmed and keep them moving through learning content at a productive pace. Moreover, it will ensure your matching quizzes display nicely on all devices.

Learner Experience

When learners encounter a matching knowledge check, they'll be instructed to create matches by joining cards that correspond with one another. These pairs will be randomized each time the element is refreshed.

Matches can be made two different ways: by using a mouse to drag and drop the cards into place, or by clicking an answer, then clicking its match in sequence. To remove a match, click the X on a card.

Once learners are satisfied with their answers, they can validate their responses by clicking Check Answer at the bottom of the element. Learners will receive immediate, automatically graded feedback. Incorrect answers will be marked with a red X, correct answers with a green check mark.

This screenshot shows the matching element from the learner's point of view.

When incorrect answers are present, Check Answer will instead read Try Again. Clicking this button will restore the answers to the match bank in their original order. The correct and incorrect indicators will disappear, and the learner will be permitted a fresh attempt at the quiz.

Once learners answer the quiz correctly, the Check Answer/Try Again button will be disabled, and learners will not be able to retry the question unless the lesson is restarted or reassigned.

πŸ’‘ Note: Knowledge checks are required and cannot be made optional at this time. Moreover, it's not sufficient that learners merely answer the knowledge check. They must solve it by clicking 'Check Answer' to verify their choices. Should a learner attempt to complete a lesson without checking their knowledge, they'll be met with a notice like this one:

Frequently Asked Questions

Q. Can images be used in matching tiles?

A. Not at this time, but we can see the potential for teaching and learning! Do you want to add images to your matching tiles? Let us know: send your ideas and suggestions to our product feedback portal.

Q. Is the matching element graded?

A. No, learners can retry it without penalty.

Q. Do learners need to complete the matching element to finish a lesson?

A. Yes, this knowledge check must be answered correctly before learners can finish the lesson.

Q. Is a prompt required?

A. Yes, a prompt is required to complete the matching element. The element must be completed before the lesson containing it can be published.

Q. Is there a reset button for this knowledge check? In other words, I got it right, but I want to see why my choice was the best option.

A. This is not possible. You can only click 'Try Again' if you were wrong.

Q. Can a matching element be added to the element library?

A: Yes, matching elements can be added to the element library for reuse in future lessons.

Q. Why is there a character count for cards in the matching element?

A: Matching cards are limited to 90 characters. This limit ensures that matching puzzle pieces can be read on mobile devices.

Q. Will matching attempts be included in any reporting?

A. Matching attempts will not be included in Lessonly reporting at this time.

Questions? Contact the Support team at

Did this answer your question?