Blocks Overview

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

1. Open a lesson in the editor
2. Click Add Block (the +)
3. Either pick a block type from the palette, or describe what you want in the input above the palette to let AI build it (see below)
4. Configure the block in the editor panel

Blocks can be reordered by dragging within the lesson.

Build a block with AI

Not sure which block fits? Describe what you want in plain language and LearnBuilder picks a block type and fills it in for you.

1. Click the + to add a block. Above the block palette there's an input field — click it (or start typing) to open the block-builder chat.
2. Describe the block you want — for example "a 5-question quiz on phishing red flags" or "a roleplay where the learner calms an upset customer". The examples shown are tailored to the current lesson; click one to start from it.
3. The assistant may ask one quick question (e.g. how many questions, or scene vs. messenger dialogue), then proposes a block — the type, a name, and a short spec.
4. Click Create block. The block is inserted and generated in place; click Keep refining to adjust first.

What it can create

• Filled from your description — Quiz, Flipcards, Drag & Drop, Hotspot Image, AI Dialogue, Graph, Feedback, Accordion / Tabs, Process Flow, Slideshow, and Text are generated directly from the brief.
• Interactive Slides — built with the interactive-slideshow generator; the block shows a "Generating…" placeholder and fills in when ready.
• Custom Embed — the code is generated from your brief, the same as the embed block's built-in AI.
• Talking-head Video — give the line and name the speaker (e.g. "a talking-head video with @Cassius saying 'It's just branded merch, everyone gets one'"). The matching course character's portrait and voice are pre-selected; confirm in the video dialog and it generates in the background. You can write the name with or without the @.
• Upload-based blocks (Audio, 360° Image, Document, SCORM/xAPI) are created ready for you to add the file.

Tip: Be specific — include a count, tone, or topic. Naming a course character casts AI Dialogue and Talking-head Video with that person automatically. You can always edit the block afterwards in its own editor.

Block types at a glance

Content delivery

Assessment & practice

Interactive & scenario-based

External content

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

1. 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).
2. The Conditions modal lists every existing condition for that block. Click Add Condition to add a new one.
3. 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
4. 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
• Use Workbook for reflective, build-as-you-go courses where learners capture their own answers across lessons and leave with a completed, downloadable document

Detailed block docs

• Quiz blocks — all question types and AI grading
• Workbook blocks — persistent learner-authored fields + downloadable workbook
• Interactive blocks — AI Dialogue, Accordion/Tabs, Hotspots, 360° Image, 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.