Block-Based Lessons
Who this guide is for: Authors and admins building lesson content directly in EmbayLMS (no SCORM or external file needed) using stacked content blocks.
Overview
An HTML module is a lesson you build from a sequence of blocks — text, image, video, and embedded quiz — instead of uploading a file. Learners see the blocks rendered in order in the course player.
Block types:
| Block | What it shows |
|---|---|
| Text | A paragraph of lesson text |
| Image | An image (by URL) with alt text for accessibility |
| Video | A YouTube / Vimeo embed, or a direct video URL |
| Quiz | An existing quiz module from the same course, embedded inline |
Building a lesson
- Open a course (draft version) → Modules.
- Add a module of type HTML (or open an existing one). The Lesson content editor appears below the module.
- Click a block type (+ Text / Image / Video / Quiz) and fill it in:
- Text — type the lesson text.
- Image — paste an image URL and an alt-text description.
- Video — choose YouTube, Vimeo, or Direct URL, and paste the link.
- Quiz — pick one of the course’s quiz modules (add a quiz module first if the list is empty).
- Use ↑ / ↓ to reorder blocks and Delete to remove one. Changes save as you go.
- Edit any block inline and click Save.
Quiz blocks reuse the course’s existing quiz engine: the quiz still lives in its own quiz module (attempts, grading, and completion are tracked there) and is simply shown inline within the lesson.
Configuration reference
| Field | Notes |
|---|---|
| Module type | Must be HTML for the block editor to appear |
| Block order | Up/down controls; persisted immediately |
| Text content | Plain text with line breaks (rich-text formatting is a planned enhancement) |
| Image URL | Must be a reachable https:// URL; always add alt text |
| Video provider | YouTube, Vimeo, or Direct URL |
| Quiz reference | Points to a quiz module in the same course |
How completion works
An HTML lesson is a passive module — it completes when the learner has viewed it (like a document), per the per-module completion engine. If the lesson contains a quiz block, the quiz’s own pass/grade is tracked against its quiz module independently.
Troubleshooting
| Problem | Cause / fix |
|---|---|
| No Lesson content editor on a module | The module type isn’t HTML. Create/convert it to an HTML module. |
| + Quiz is disabled | The course has no quiz modules yet. Add a quiz module first, then add the quiz block. |
| Learner sees “Quiz unavailable” | The referenced quiz module has no quiz configured, or the learner isn’t enrolled. Configure the quiz in its module. |
| A video doesn’t play | Use a standard YouTube/Vimeo watch URL, or a direct video file URL. Shorts URLs aren’t supported. |
| Changes don’t appear for learners | Publish a new course version — block edits apply to the draft until you publish. |