Building lessons¶
Lessons are the building blocks of your course. They can have different content types — from simple text through video to interactive H5P. This page explains how to create lessons and which type is right for what.
Creating a new lesson¶
- Switch to Lessons in your course.
- Click New lesson.
- Select the lesson type (see the table below).
- Give it a title — learners see it in the lesson list.
- Enter the content (varies by type).
- Save.
Screenshot to follow
Lesson editor with type selection and title field
Which lesson types exist¶
| Type | What's possible | When it makes sense |
|---|---|---|
| Video | Embed a video from the media library + optional accompanying text | Demonstration, explanation, lecture |
| Document | PDF or other file to view / download | Scripts, handouts, reference material |
| Info text | Plain text with formatting | Explanations, overviews, introductions |
| Multiple choice | Question with answer options, one or several correct | Knowledge check, self-test |
| Free text | Open question, answer automatically graded by the AI | Reflection, applied expertise, depth |
| Cloze text | Text with gaps to fill in | Practicing vocabulary, technical terms |
| Matching | Assign terms or images to categories | Learning classification |
| Drag and drop | Sort or place elements | Sequences, arrangements |
| Hotspot | Image with clickable areas | Explaining anatomy, diagrams, charts |
| Timeline | Order events chronologically | History, processes |
| H5P | Interactive content (Interactive Video, Quiz, Memory, …) | Highly interactive learning units — see Creating H5P content |
| SCORM | Embed an external SCORM package | Existing SCORM content from other tools |
The selection is large — as a rule of thumb: multiple choice for quick knowledge checks, H5P when you want a bit more of a wow effect, free text when you want to demand depth.
Order and sequencing¶
In the lesson list you can reorder lessons via drag and drop. In a sequential course the order determines what learners get to see when.
The lesson list also recognizes:
- Mandatory lessons vs. optional lessons (via a toggle)
- Prerequisites within the course (e.g. "only unlock this lesson once that one is completed") — in sequential courses this is implicit, in free courses you can enforce individual orderings selectively
Tips for each type¶
Video lessons¶
- Embed videos from the media library — upload the video before creating the lesson.
- Accompanying text below the video is useful for: key learning objectives, pointers to certain spots in the video, source references.
- Long videos (>15 min) are often better split into several shorter lessons.
Multiple-choice quiz¶
- 3-5 answer options per question, ideally all plausible (no obviously wrong distractors).
- Mark the correct answers — the system grades automatically.
- Explanation per answer (optional) — learners see it after submitting, so they also learn from wrong answers.
Free-text lessons with AI grading¶
- Clear task — what should be assessed, which aspects matter?
- Provide a model answer — the AI compares against it; the more precise, the better the grading
- Define grading criteria — e.g. "professional correctness", "completeness", "own contribution"
- Set a maximum number of points — learners see their score
AI grading is an aid, not a final verdict. For critical assessments (mandatory certificate courses) plan for a manual review.
Cloze text¶
- Set precise gaps — one gap per term, not whole sentences
- Configure synonyms as "also accepted" where it makes professional sense
- Watch out for case-sensitivity tolerance
H5P¶
→ Separate guide: Creating H5P content
SCORM¶
- Upload a prepared SCORM package as a ZIP file to the media library
- Select the ZIP when creating the lesson
- Caution: SCORM content is loaded in an iframe — it may differ stylistically from your course
Copying lessons¶
Currently not directly supported in the UI. Pragmatically:
- For H5P content: H5P offers its own "copy" feature in the editor
- For other types: copy the content manually from one lesson into the other
Deleting lessons¶
In the lesson editor at the bottom, Delete. For courses that are already running: bear in mind that learners lose notes or bookmarks for the lesson.
Frequently asked questions¶
How long should a lesson be? Most well-functioning lessons take 5-15 min to work through. Very short lessons (< 2 min) feel like fragments, very long ones (> 30 min) are tiring — better to split them.
Learners complain that quiz answers are marked "wrong" even though they make sense. For cloze/free text: add synonyms or accepted spellings. For multiple choice: check whether the marking of the correct answer really fits.
Can I format content in the lesson editor (bold, lists, images)? For info-text lessons yes, with a full rich-text editor including images, tables, code blocks. For quiz questions usually only basic text — a question should be phrased briefly and clearly.
How can I see where learners drop off? In the Analytics area → your course → Lesson detail breakdown: shows completion rates and average time per lesson. An unusually low completion rate or a very long processing time often indicates a need for clarification.
Can I play through lessons as a learner for testing? Yes — in the course editor there's a preview mode that lets you play through the course as a learner, without your trainer status revealing stored quiz answers.