{{ summaryTitle }}
{{ summaryValue }}

{{ summaryLine }}

{{ badge.label }} {{ badge.value }}
{{ summaryAnnouncement }}
Vocabulary matching worksheet inputs
Paste rows, drop text, or load one TXT/CSV file. The source stays in this browser.
{{ sourceStatus }}
Auto uses the first supported separator on each row. Pinned formats reject rows that do not use that separator.
Save this seed with the lesson when a reprint must keep the same answer mapping.
Changing this setting renumbers the term side and the answer key.
Seeded shuffle is the normal matching-sheet path.
Letters are easiest to distinguish from numbered term prompts.
Two columns suit the default science set.
No blank works when students draw lines or answer orally.
The summary reports how many marked choices are active.
{{ include_distractors ? 'Included' : 'Excluded' }}
Off keeps the printable worksheet student-ready.
{{ include_answer_key ? 'Teacher copy' : 'Student copy' }}
The default title is ready for a general classroom worksheet.
Keep the direction short enough for the printed header.
US Letter is the default; choose A4 when that matches the classroom printer.
Auto affects only the first non-empty pair-shaped row.
This changes review findings, not the accepted source rows or answer mapping.
Off is neutral and preserves the normal worksheet spacing.
{{ compact_print ? 'Compact' : 'Standard spacing' }}
{{ worksheetExportStatus }}
Student worksheet

{{ normalized.worksheet_title }}

{{ normalized.student_instructions }}

Name: ____________________Date: ____________

Terms

  1. {{ row.term }}

Choices

  1. {{ row.label }}. {{ row.definition }}

Answer key

{{ row.number }}. {{ row.answer_label }}
{{ tableExportStatus }}
#TermAnswerDefinitionCopy
{{ row.number }}{{ row.term }}{{ row.answer_label }}{{ row.definition }}
{{ chartExportStatus }}

The chart renderer is unavailable. Definition lengths remain listed in the teacher check and source artifacts.

{{ tableExportStatus }}
CheckStatusDetailCopy
{{ row.check }}{{ row.status }}{{ row.detail }}
{{ tableExportStatus }}
LineStatusDetailCopy
{{ row.line }}{{ row.status }}{{ row.detail }}

Introduction

Matching asks learners to connect terms with a separate bank of definitions. It works well for recognition, recall, lesson warmups, review sheets, and quick checks before a class moves into writing or application. The format is less suitable for proving that a learner can explain a concept, use it in context, or transfer it to a new problem.

The quality of the source list matters more than decorative variety. Terms should belong to a coherent topic, definitions should preserve the distinction between nearby ideas, and wording should not reveal answers by grammar or length. When one definition is a paragraph and the others are short phrases, learners may match by appearance instead of meaning.

Vocabulary matching design choices
Choice Useful when Risk to check
Shuffled choices The answer bank should not mirror source order. A new shuffle without a saved seed makes reprints and answer keys disagree.
Shuffled terms Several worksheet versions should vary both sides. Numbering changes, so each version needs its matching answer key.
Distractors Extra choices remain plausible within the topic. An extra definition may also fit a real term or may be obviously unrelated.
Short definition bank Learners need a scannable review rather than a reading-endurance task. Over-shortening can remove the distinction the item is meant to test.

A distractor is an extra definition with no correct term on the sheet. It should be written and reviewed deliberately; an automatic plausible-sounding decoy can accidentally become a second correct answer. Duplicate definitions create a similar problem because one label may appear interchangeable with another.

One seed can preserve a worksheet version. If the source terms, definitions, order settings, and seed remain fixed, the same labels and answer mapping can be produced again. Changing the seed creates a new arrangement, so the answer key from an earlier version should not be reused by assumption.

Before distribution, read the worksheet as a student would. Check that every term has one defensible answer, every extra choice is genuinely extra, the definitions fit the page, and the directions say whether students should write a label, use a box, draw lines, or answer aloud.

How to Use This Tool:

Prepare the term-definition list first. The worksheet can arrange and check supplied content, but it does not write or fact-check definitions.

  1. Paste rows into Term-definition pairs or load one TXT or CSV file. Choose Auto detect for mixed supported separators, or pin one format when every row should follow it.
  2. Set a stable Version seed, then choose whether terms and choices stay in source order or shuffle. Mark optional extras as distractors in the source; the generator does not invent them.
  3. Choose labels, columns, and the student response style. Under Advanced, set the title, directions, paper size, header handling, duplicate matching, and compact print spacing.
  4. Resolve invalid or duplicate rows in Parse ledger, then inspect Teacher check for long definitions and print fit. Keep the separate answer key with the same seed and source version.

Interpreting Results:

Ready means the source has at least two valid pairs and no invalid rows, duplicate findings, or definitions longer than 140 characters. Review points to one of those content or parsing conditions. A worksheet can still be grammatically valid while containing a wrong, ambiguous, or instructionally unsuitable definition.

The Answer key is derived from the identity of each parsed pair after the selected shuffles. Verify that every term points to exactly one labeled definition. Marked distractors appear in the choice bank only when enabled and never receive a correct term.

Treat Text-tight as a layout warning. It appears when any included definition exceeds 140 characters or the choice bank has more than 24 entries. Shorten definitions, reduce the number of choices, change the column count, or print a test page before distributing the sheet.

Technical Details:

Each non-empty source line is parsed into either a term-definition pair, a marked distractor, or an invalid row. Auto detection checks for a tab, pipe, comma, then a spaced hyphen or dash on each line. A pinned format rejects a line that does not contain its selected separator.

Transformation Core:

  1. Parse: read each row, recognize an optional first header, and preserve the source line number.
  2. Classify: separate valid pairs, explicitly marked distractors, invalid rows, and duplicate findings.
  3. Order: keep or seed-shuffle terms and choices independently, using separate term and choice streams derived from the same seed.
  4. Label: assign letters, numbers, or Roman numerals to the ordered choice bank.
  5. Map: join each displayed term back to its original definition identity and record the current choice label in the answer key.
  6. Render: build the printable terms, choices, response spaces, directions, and optional embedded answer key.
Vocabulary source parsing rules
Source pattern Interpretation
Tab, pipe, comma, or spaced dash The first cell is the term and the remaining content forms the definition. Quoted CSV fields may contain commas and doubled quotes.
distractor:, decoy:, extra:, or unused: The remaining text becomes a marked distractor rather than a term pair.
Recognized first-row labels With automatic header handling, a first pair such as “Term, Definition” is skipped as a header.
Missing side or separator The row is retained as invalid evidence and does not become a pair.

Rule Core:

  • At least two valid term-definition pairs are required before a worksheet can be produced.
  • The source may contain up to 50,000 characters, and the required seed may contain up to 80.
  • Duplicate checks compare terms, definitions, and distractors either with or without case sensitivity. They flag repeated content but do not delete valid pairs.
  • Terms and choices shuffle independently. The same source, seed, and order settings reproduce the same worksheet and answer mapping.
  • Only marked distractors are eligible for inclusion. Turning distractors off removes them from the choice bank without changing valid pair identity.
  • Choice columns are limited to 1 through 3, and the response can be a line, a box, or no printed blank.

The worksheet title is limited to 90 characters and directions to 180. The printable answer key is off by default so the student sheet remains clean, while a separate answer key stays available for teacher review.

Accuracy and Privacy Notes:

Source text and loaded files are processed in the browser. The generated checks evaluate structure, duplicates, length, and answer mapping; they do not verify factual accuracy, reading level, curriculum alignment, or whether two definitions overlap in meaning.

  • Review every distractor for accidental second answers before distributing the worksheet.
  • Print or preview the selected paper size because browser and printer margins can change line wrapping.
  • One matching activity measures recognition more directly than explanation, contextual use, or long-term mastery.