AI Lesson Generation

Who this is for

Teachers who want to draft lesson content quickly with AI and then refine it in the Lex Editor. The same Lesson Plan and generation workflow is available when a student is allowed to author a self-study lesson.

What this page answers

• Which AI entry point should I use?
• How do I prepare a Lesson Plan and generation brief?
• What happens when a whole-lesson write is partial or interrupted?
• What should I review before publishing the result?

Prerequisites

• a course or lesson where you can edit and generate content
• access to the relevant plan allowance or AI credit balance

AI generation works with the Lesson Plan's ordered Steps. You can write the whole lesson from the Canvas view on the floating bottom dock, write one Step, or use Ask AI for a focused editing request.

Choose the right entry point

Prepare the Lesson Plan

Before generating, choose Canvas (or Canvas · {count}) on the floating bottom dock. The plan rail shows the ordered Steps, Stage labels, time targets, and Step settings. A lesson with a plan but no written content stays in Canvas view until at least one Step contains content. A lesson with no plan shows the offer to create one.

Set the lesson-wide details first:

• theme or situation
• CEFR level
• target and explanation language
• method and delivery context
• target duration
• instructions that apply to every Step

Then check each Step's type, time, exercise count (up to 60 exercises per Step), and brief. Exercise counts are managed as a structured form field directly inside the Step card. A Step brief should describe what that Step should contain, not repeat the whole lesson brief.

Configure Step-specific options

Some Step types expose extra controls before generation:

• Pronunciation Assessment - add teacher-supplied target words or short phrases when the drill should use exact vocabulary. Note that words in standard Word List (:::word-list) widgets use free platform-cached audio that costs 0 AI credits.
• Sentence Gap - configure reading coherence passages and distractor fragments.
• Category Sort - configure categories and items, including deliberate cases where an item fits more than one category.
• Handwriting Check - set student instructions, upload limits, and the mistake categories to review.
• Teacher notes - add private guidance for teaching; these notes are not student instructions and are not used as hidden generation instructions.

The plan also includes a Material Style or method choice where available. Use it to describe the kind of lesson document you need, such as teacher-led practice, communicative work, narrative self-study, or a task-based flow.

1. Write a focused brief

The quality of the result depends on how specific you are. Include:

• the lesson theme or situation
• CEFR level
• target and explanation language
• lesson length or scope
• what to include or avoid
• any Step-specific requirements in the Step's brief

Good prompts are narrow and instructional, for example:

• Spanish A2 lesson on reflexive verbs in morning routines
• English B1 reading lesson about travel delays with vocabulary and comprehension practice

2. Preflight cost estimate & generation

Before you generate, the Live Rail displays a preflight cost estimate in AI credits. The estimate calculates the credit cost based on the lesson's CEFR level, the active Step count, and the selected exercise types. Input tokens cached by the provider receive an automatic discount.

Choose Write the whole lesson from the plan rail. The editor prepares the shared lesson context, then writes one Step at a time. Progress appears on the Step cards with live status indicators, so you can see which Steps are waiting, writing, complete, or failed.

Steps finish independently. One Step can complete while another is still writing, and a failed Step does not remove the Steps that already finished. Completion order can vary; use the Step cards to review the actual result rather than relying on the order in which progress messages appear.

The plan remains visible in the Canvas view while generation runs. If you realize the brief is wrong, click Stop. Canceling an in-flight generation stops remaining Steps immediately, incurs no cancellation fee, and leaves any completed Steps in place.

Generate or retry one Step

Use Write this step on an empty Step. The Live Rail displays the estimated credit cost for that specific Step before you click. If the Step fails, the card offers Write it again; retrying that Step does not rewrite the rest of the lesson.

To regenerate a Step that already contains content:

1. Open the Step actions menu.
2. Choose Replace this step.
3. Read the warning and confirm that the existing Step content can be removed.
4. Review the new Step before saving or publishing.

This is a replacement action, not an insert-alongside action. If you want an additional activity, add another Step or insert content through Lesson blocks.

3. Recover partial or interrupted generation

Whole-lesson generation is designed so that already completed Step content can be kept while an unfinished Step is retried.

If the connection drops or progress stops:

1. Keep the editor tab open while it reconnects. If the editor says Not syncing - keep this tab open, do not close the tab.
2. Return to the Canvas view and check the Step cards.
3. Treat completed Steps as available for review.
4. Use Write it again only on a Step that is empty or marked as failed.
5. Switch to the Lesson view and review the lesson before assigning or publishing it.

If a network disconnect occurs before generation settles, the job is abandoned and no AI credits are billed. Furthermore, if you edit a Step's text manually while generation is in flight, the editor's edit conflict fence protects your work: the late-arriving generated text will not overwrite your manual edits and is safely routed to recovery.

If the editor shows a busy or waiting state, another write is still being handled. Wait for the current state to resolve, then use the available Step action rather than starting duplicate whole-lesson writes.

For a published lesson, generated content is reviewed in an unpublished Working Copy. The Working Copy lets you check partial output and make edits before publishing it to students. A disconnect does not make a completed Step disappear, but you should wait for a fresh connection before saving or publishing.

See Generation History for the generation record and a summary of partial or failed attempts.

4. AI Content Claims and refunds

If an AI generation produces defective or unusable content (such as broken grammar, incorrect language level, or corrupted formatting):

• You can submit a claim within 90 days of generation to request a refund of the spent AI credits.
• Claims with a written explanation (at least 20 characters) are eligible for an instant automatic refund (limited to 1 automatic refund per 7 trailing days).
• If you simply want to report poor quality without requesting a refund, use the thumbs-down quality signal. This helps improve future generations without consuming your 7-day refund allowance.

5. Review before you trust the result

Treat the generated lesson as a strong first draft, not finished teaching material. Always review:

• accuracy of grammar, translation, and examples
• level fit for your students
• exercise answer quality
• answer explanations and teacher notes
• tone and clarity
• Step order and Stage labels
• widget configuration, generated media, and AI-created audio

Fast widget review

Use Widget Edit Mode (eye icon) on the floating bottom dock to review generated exercises quickly. This dock button switches exercise widgets in the lesson into edit mode so you can scan correct answers, options, instructions, scoring settings, and generated widget content without opening each widget one by one.

After checking, click the eye icon again on the floating bottom dock to exit widget edit mode and return the lesson to normal student-facing behavior. Do not leave the lesson with all widgets still in edit mode.

Finish generated media

Some generated widgets intentionally appear in edit mode after generation, such as image prompts and audio dialogues. Open the widget, review the prompt or script, correct it if needed, and click Generate to create the finished asset.

Pronunciation activities may also need reference audio prepared before assignment. Do this during lesson preparation when students should receive a ready-to-use activity.

6. Edit, save, and publish

Switch to Lesson view on the floating bottom dock to edit the lesson as a document:

• rewrite explanations in your teaching voice
• adjust instructions and exercise difficulty
• add content blocks, media, comments, or extra practice
• use Clear answers (eraser icon) on the floating bottom dock to reset test responses
• keep or remove Steps through the Canvas view

When the lesson is ready:

1. save your changes
2. review the Working Copy if the lesson was already published
3. publish only after the Step content and widgets are ready for students
4. check Generation History when you need to understand an earlier attempt

Languages the Lesson Builder covers

Lesson Builder presets cover 15 teaching languages:

English, Polish, German, French, Spanish, Czech, Italian, Lithuanian, Dutch, Portuguese, Swedish, Bulgarian, Ukrainian, Arabic, and Mandarin Chinese.

Each has A1-C2 presets and a topic bank. Bulgarian includes full Cyrillic script support, verb aspect and clitic pronoun rules, standard dictionary forms, and stress accent normalization. Mandarin Chinese supports both Simplified and Traditional scripts, Putonghua pronunciation, Pinyin answer evaluation, and character-based writing counts. Arabic includes Right-to-Left (RTL) script formatting and Modern Standard Arabic presets. Leave the topic blank when you want the generator to choose a topic for the selected language and level.

Speaking Steps: live or recorded

A speaking Step has a Response mode setting that decides how the student speaks:

Automatic mode chooses recorded practice for self-study lessons and narrative lessons, and live-with-teacher practice otherwise. Set it explicitly when the default would be wrong.

Self-study also offers the Live Examiner speaking task. Here “live” means an audio role-play with the AI examiner, not a teacher joining the lesson. Select it deliberately; an ordinary speaking Step in self-study remains a recorded task.

Which language the lesson is written in

In self-study lessons

Self-study lessons follow a stricter language policy because there is no teacher in the room to bridge between two languages.

• Everything the student sees defaults to the target language.
• Two languages are not mixed inside one sentence. Where bilingual content is needed, use separate paragraphs, bullets, or table cells.
• At A1 and A2, a student's native language may appear briefly for a genuinely difficult concept, an explicit comparison, or a dedicated vocabulary translation.
• From B1 upward, everything the student sees is in the target language, including vocabulary definitions.

In teacher-led lessons

Outside self-study, the native language is used for grammar and theory, the target language for examples and tasks, and your teacher notes can request a different balance.

AI Generation for Mathematics Lessons

When authoring courses with the Mathematics teaching subject:

• Full Games & Brain Breaks Generation: Teachers can generate and revise all standard word games (Memory Game, Word Search, Crossword, Word Scramble, Flashcards) and brain breaks (Drawing Board, Roulette, Breathing Timer, Would You Rather) via the Lesson Plan builder or Ask AI ("Add games and a break").
• Reinforcing Math Terminology: Generated word games in math lessons focus on mathematical vocabulary, geometric concepts, definitions, and mental resets rather than calculation exercises. Content is output as plain text without nested formulas.
• Custom Term Lists: Teachers can provide custom term lists in Step briefs or prompt the AI to extract key vocabulary directly from earlier theory sections.
• Quota Separation: Game and brain-break sections are budgeted and counted independently from calculation exercises, ensuring lessons maintain a balanced mix of instruction, active problem-solving, and play.

Related pages

• Lesson Builder & Lesson Blocks
• Generation History
• Lex Editor Guide
• Materials Library
• Exam Preparation
• Billing & AI Credit