Blocks Overview
All content block types available in the LearnBuilder lesson editor.
Blocks are the individual content pieces inside a lesson. Each block serves a specific purpose — delivering content, testing knowledge, or creating an interactive experience.
Adding a block
- Open a lesson in the editor
- Click Add Block
- Choose a block type from the picker
- Configure the block in the editor panel
Blocks can be reordered by dragging within the lesson.
Block types at a glance
Content delivery
| Block | Purpose |
|---|---|
| Text | Rich text with formatting, images, and links |
| Video | Embed YouTube/Vimeo or upload a video file |
| Audio | A standalone audio player — upload a file, pick from the media library, or generate speech from text with AI |
| Slideshow | Standard slide presentation |
| Document | Embed a document for learners to view |
| Custom Embed | Build custom interactive content with HTML/CSS/JS — write code or let AI generate it |
| Graph | Display data as a chart or visualization — type values in or import a CSV |
| Accordion / Tabs | Three layouts in one block — collapsible accordion, classic tabs, or image-rich Strips — with per-section background image or colour |
Assessment & practice
| Block | Purpose |
|---|---|
| Quiz | Questions with multiple types — MC, essay, fill-in-the-blank, and more |
| Flipcard | Flip cards for memorization and recall |
| Drag & Drop | Matching or sorting activities |
| Feedback | Survey-style feedback form with ratings, scales, and open-ended questions |
Interactive & scenario-based
| Block | Purpose |
|---|---|
| AI Dialogue | Branching conversational scenario powered by AI |
| Hotspot Image | Clickable areas on an image with reveal content |
| Interactive Slides | Visual slide authoring with a canvas editor, element library, and trigger-action interaction system |
| Process Flow | Visual step-by-step process diagram |
| Live Session | Instructor-led training block — schedule a session, manage registrations, and track attendance |
External content
| Block | Purpose |
|---|---|
| SCORM / xAPI | Import a SCORM or xAPI package from an external tool |
Per-block layout & background
Every block has a Layout & Background modal (open from the block's … menu) with three sets of controls:
- Width — Standard (sits inside the lesson column) or Full width (background spans edge-to-edge; text content stays at a readable max-width inside).
- Background — colour, gradient, image, or any combination. Image opacity is independently adjustable so a faded photo can sit over a brand colour.
- Padding & margin — four sides each, in pixels. Padding is space inside the block's background; margin is space outside it. Sensible defaults are pre-loaded so a fresh block looks right; the Reset button restores them.
Live preview is on by default — every slider drag updates the actual block in the editor. Cancel restores a snapshot taken when the modal opened.
Conditional visibility (Show conditions)
Any block can be shown only when one or more earlier blocks reach a specific state. Use this for branching lessons — for example, hide an "advanced" block until a quiz is passed, or show a remedial explainer only when an assessment is failed.
Setting conditions
- Open the block's
…menu → Conditions (the option is disabled for the very first block in the lesson, since there's nothing before it to react to). - The Conditions modal lists every existing condition for that block. Click Add Condition to add a new one.
- Each condition row has two pickers:
- The previous block to watch. The dropdown only lists blocks that appear above the current block in the lesson, so you can never reference a block the learner hasn't seen yet.
- The state that block must be in. Options depend on the chosen block type:
- is completed — the learner has finished interacting with the block (every block supports this)
- is passed / is failed — for graded blocks (quizzes, drag-and-drop activities, interactive slides with scoring), reads the outcome
- rating is … — for Feedback blocks with rating questions, you pick the question and compare the learner's rating using
>,<,=,>=,<=against a numeric value
- Add as many condition rows as you need. Click the trash icon next to a row to remove it.
How multiple conditions combine
All conditions must be met for the block to be shown — they combine with logical AND. For OR-style branching, create two separate blocks: one for each branch with its own condition.
What learners see
Blocks with unmet conditions are completely hidden from the lesson — the learner doesn't see a placeholder, they just see the next block that does qualify. As the learner progresses and completes / passes / fails earlier blocks, hidden blocks reveal themselves automatically.
How it shows in the editor
Blocks with one or more conditions display a small branch icon badge in the block header so you can see at a glance which blocks have conditional visibility configured.
Tip: Combine conditional blocks with the Quiz and Feedback outcomes to build branching paths — pass the quiz to reveal the next module, fail it to reveal a "Review the basics" block, give a low rating to surface a "Tell us more" follow-up.
Choosing the right block
- Use Text for explanations and theory
- Use Video for demonstrations and walkthroughs
- Use Quiz to check comprehension after a concept
- Use AI Dialogue for roleplay, customer scenarios, or soft-skills practice
- Use Flipcard for vocabulary, definitions, or memorization
- Use Feedback to collect learner reactions, satisfaction ratings, or course evaluations
- Use Process Flow for step-by-step procedures
- Use Hotspot Image for diagrams where learners explore by clicking
- Use Custom Embed for anything else — AI can generate custom HTML/CSS/JS interactions from a description
- Use Accordion / Tabs to organise longer content into collapsible sections or a tabbed view, reducing visual clutter
- Use Live Session for instructor-led training that complements self-paced content — schedule virtual or hybrid sessions alongside your online lessons
- Use Audio for narration, pronunciation guides, podcasts, or any standalone listening exercise
Detailed block docs
- Quiz blocks — all question types and AI grading
- Interactive blocks — AI Dialogue, Accordion/Tabs, Hotspots, Drag & Drop, Interactive Slides, Process Flow, Feedback, Live Session
- Media blocks — Text, Video, Audio, Slideshow, Document, Embed, Graph, SCORM/xAPI
Block audio
Any block — regardless of type — can have audio attached. You can upload an audio file or generate speech from text using AI.
Audio can auto-play when the block enters view, or require the learner to click play manually. See Lessons → Block audio for setup instructions.