Label Diagram

What Label Diagram does

Label Diagram is a free Moodle activity that turns any image into a drag-and-drop labelling game. Learners drag labels onto numbered points on a diagram, one slide after another, and find out what each part does as they go.

It suits anything with parts: engines, brakes, aircraft, switchboards, plant and machinery, the heart, the skeleton, tools, PPE, a commercial kitchen. Trainers set it up in minutes, and learners get instant feedback instead of a static worksheet.

Three modes, one activityEnlarge

1234

1. 1Study: every label already placed, with "What it does" cards. Not graded.
2. 2Practice: instant right or wrong, hints and Show answers. Never graded.
3. 3Test: graded, feedback at the end, attempts and an optional time limit.
4. 4Diagram and part counts for the whole activity.

Free, no AI, and why that matters

• Free. No price, no credits, no per-learner fees.
• No AI. Every placement is checked against the labels you placed. Learners always get the same, predictable result, so the outcome is easy to defend at audit.
• Your data stays on your Moodle. Diagrams, attempts and grades are stored in your own Moodle database. No learner data leaves your site.
• Cheat-resistant. In Test mode the answer key never reaches the browser. Every placement is marked on your server, and each attempt gets fresh random tokens.

Install

1. Download the latest mod_labeldiagram ZIP from lms-labs.com.
2. In Moodle, go to Site administration > Plugins > Install plugins and drop in the ZIP.
3. Click Install plugin from the ZIP file, then Upgrade Moodle database now.
4. Optional: set the site defaults for sounds and the leaderboard.

Command line install: unzip into mod/labeldiagram (on Moodle 5.x, public/mod/labeldiagram), then run php admin/cli/upgrade.php.

Site defaultsEnlarge

12

1. 1Sounds on by default for new activities.
2. 2Leaderboard on by default for new activities.

Create an activity

Turn editing on, choose Add content > Activity or resource, and pick Label diagram. Give it a name, then choose the modes and settings.

Add a Label diagramEnlarge

1

1. 1Search "label" to find it fast.

Modes and test settingsEnlarge

12

1. 1Tick the modes learners can use. Most trainers leave all three on.
2. 2Test attempts allowed: unlimited or 1 to 10, plus an optional time limit enforced on the server.

Student experienceEnlarge

123

1. 1Shuffle the label order for every attempt.
2. 2When learners see "What it does" cards.
3. 3Leaderboard shows first name and last initial only.

Grade and completionEnlarge

1

1. 1Finish the activity: every slide, in Test mode when it is on.

Add your diagrams

Open Manage slides. Drop in images, or a ZIP of images. Each image becomes one slide, in file-name order. Each slide holds up to 10 labelled parts and 4 distractors.

Add diagram slidesEnlarge

1

1. 1Drag in images or a ZIP: up to 100 images and 200 MB at a time.

Manage slidesEnlarge

12

1. 1Each card shows the parts placed and distractors.
2. 2Preview as student at any time.

Perfect image size

Place the labels

Click Edit labels on a slide. The fastest way is Quick add:

1. Type or paste your labels, one per line. Add what each part does after a bar, for example Water pump | Pushes coolant through the engine.
2. Press Start placing.
3. Click the image once for each label. The banner shows which label is next.

Fine-tune by dragging a marker, or select it and nudge with the arrow keys (Shift for bigger steps). Delete removes it. Every change saves automatically.

The label editorEnlarge

12

1. 1Your diagram. Click to place, drag to adjust.
2. 2Start placing, then click once per label.

Click, click, clickEnlarge

12

1. 1Placed, current and still-to-place labels.
2. 2Each click drops the next label.

All placed and savedEnlarge

1

1. 1Changes save automatically.

Colours, distractors and "What it does"Enlarge

1234

1. 1Choose from 12 accessible colours.
2. 2Distractor: an extra wrong option with no drop zone.
3. 3Bold, italic and bullet points.
4. 4Live preview of the learner card.

Writing good labels

• Use the exact term learners must know, as it appears in the unit or the manufacturer's manual.
• Keep "What it does" to one or two plain sentences. Bold the key words.
• Add distractors that are believable: parts from the same system that are not on this diagram.
• Two parts with the same name, such as two bolts, are interchangeable automatically.

Study mode

Every label is already placed and joined to its point with a curved line. Learners tap any part, or any label, to read what it does. There is nothing to achieve: it is the friendly first step before Practice.

Start screensEnlarge

1

1. 1What to expect, then a short how-to animation.

Study modeEnlarge

12

1. 1Every label is already placed.
2. 2The "What it does" card.

Practice mode

Practice feels like a game. Labels sit in a tray. Learners pick one up, and it tilts as it follows the pointer. The drop zones breathe, and the nearest one snaps and lights up.

Drag and snapEnlarge

12

1. 1The nearest drop zone lights up.
2. 2Labels wait in the tray.

Right first timeEnlarge

12

1. 1Correct: the zone turns green with a tick.
2. 2What the part does.

Not quiteEnlarge

1

1. 1Wrong: the zone shakes and the label returns.

Hint and Show answersEnlarge

12

1. 1Hint highlights one label and its zone.
2. 2Show answers places the rest, with extra tries recorded.

Slide completeEnlarge

1

1. 1Slide complete banner.

• Correct: particles, a happy sound, a green tick and the "What it does" card.
• Wrong: the zone shakes and the label springs back to the tray.
• Hint shows where one label goes. Show answers fills in the rest. Both count as extra tries in the report.
• Only right-first-time placements count toward the Practice score. Practice is never graded.

Test mode

The start screen shows what learners need to achieve: the pass mark, attempts left and the time limit. There are no hints. Learners place every label, then Submit slide. Submitted slides lock.

Ready for the test?Enlarge

1

1. 1What learners need to achieve.

Test modeEnlarge

12

1. 1Time left, shown only when there is a limit.
2. 2Submit slide: marked on the server.

ResultsEnlarge

12

1. 1Score against the pass mark.
2. 2Leaderboard, when it is on.

Review answersEnlarge

12

1. 1Wrong answers show the correct one underneath.
2. 2The card explains the part.

• The answer key never reaches the browser. Every placement is marked on the server.
• The time limit is enforced on the server, with a short grace period for slow connections.
• Results show a score ring against the pass mark, with confetti and a fanfare for a pass.
• Review answers shows every slide, what was placed, the correct answer and the "What it does" card.

Phones, keyboards and accessibility

Not everyone can drag. On a phone, learners tap a label, then tap its number. The layout stacks the diagram, drop zones and labels so everything fits without scrolling sideways.

• Keyboard: Tab to a label, Enter to pick it up, Tab to a drop zone, Enter to place it, Escape to cancel.
• Screen readers: every pick-up, placement and result is announced.
• WCAG 2.1 AA: label colours use darker shades behind white text, whatever colour you pick, and there is always an alternative to dragging.
• Reduced motion: tilts and animations are turned down when the device asks for less motion.
• Full screen works everywhere, including on iPhone.

Grades and completion

Test scores go to the gradebook using the grading method you choose. Practice and Study are never graded. Set a grade to pass, and use completion rules such as Finish the activity and Receive a passing grade.

GradebookEnlarge

1

1. 1One grade item per Label diagram activity.

Reports

Open Reports from the activity.

• Part difficulty, Test: the percentage of responses wrong for each part, the percentage of learners who got it wrong at least once, how often it was left blank, and the label it is most often confused with.
• Part difficulty, Practice: right first time, and the average and most tries before learners get each part right.
• Attempts: filter by mode and group, delete attempts with grades and completion recalculated, and download to CSV, Excel, ODS and more.

Part difficulty: TestEnlarge

12

1. 1Summary: learners, attempts, average, time and pass rate.
2. 2Most often confused with.

Part difficulty: PracticeEnlarge

AttemptsEnlarge

Permissions

Guests can use Study mode. Separate groups are respected in reports and the leaderboard.

Privacy, backup and data

• Backup and restore: slides, images, labels, settings, attempts, answers and grades all carry across. Duplicate, import, course copy and Sharing Cart work.
• Privacy API: attempts and answers are included in data exports and deleted on request.
• Course reset: "Delete all label diagram attempts" clears attempts and grades.
• No external calls: the plugin makes no calls to outside services. Everything runs on your Moodle.

Any subjectEnlarge

Questions

Changelog

Every screen

Every screenshot on this page is a real capture from Label Diagram 2.0.5 running on Moodle 5.3.

Three modes, one activityIn your courseAdd a Label diagramModes and test settingsStudent experienceGrade and completionSite defaultsAdd diagram slidesManage slidesThe label editorClick, click, clickAll placed and savedColours, distractors and "What it does"Start screensStudy modeDrag and snapRight first timeNot quiteHint and Show answersSlide completeReady for the test?Test modeLocked once submittedResultsLeaderboardReview answersGradebookPart difficulty: TestPart difficulty: PracticeAttemptsAny subjectSwitchboard test