Build a quiz lesson

A quiz or test lesson reports a score to your LMS, unlike other lesson types.

Before you start

Give a lesson the type Quiz or Test on the Lessons step: click the type pill under the lesson title and pick Quiz or Test. Or use a lesson that already has that type.

Quiz or test?

Both types open the same quiz editor with the same question types. A quiz checks one lesson. A test is the final check of the whole course. They differ in four ways:

  • What the AI prompt asks for: for a quiz, questions about the lesson you describe in What is this lesson about. For a test, a test covering the whole course: the prompt lists the titles of all your lessons, and the field is called What does this test cover.
  • Default pass mark: a new test starts at 70%, a new quiz at 80%. These defaults are Test threshold (%) and Quiz threshold (%) under Scoring thresholds on the Settings step. Change Pass mark (%) in the editor for a single quiz or test.
  • Attempts: a new test starts with Attempts set to 3. A new quiz starts at 0, which means no limit. A test saved for the first time without an attempts setting, for example from a connected AI chat, also gets 3.
  • Course completion: only a test can decide whether the whole course is passed. Choose Final test passed with score under Passing criteria on the Settings step. This option needs a Test lesson with content. Without one, it is unavailable, and a course that already uses it shows "This course uses 'Final test passed with score' but has no Test lesson. Add a Test lesson or switch the passing criterion in Settings." The pass mark of the last Test lesson in the course, set in its quiz editor, then decides, and the Settings step shows it instead of the Pass percentage field.

With Final test passed with score, your LMS gets the course status and score only from that last test. Quiz results still reach the LMS as answers, but they do not change the course score. With All lessons completed, quizzes and tests report the same way. See What your LMS will report.

Question types

The quiz editor has six question types. Each question is worth one point, and only a fully correct answer counts.

Type What the learner does
Single choice Picks the one correct answer.
Multiple choice Selects all the correct answers.
True or false Decides whether a statement is true.
Fill in the blanks Types the missing words or picks them from a word bank.
Put in order Puts the items in the right order with the arrows.
Match pairs For each term, picks the matching answer from a list.
Question 11 of type Match pairs in the quiz editor: the highlighted Type field set to Match pairs, the question Match each term to its meaning, three term and meaning pairs such as Phishing and A fake message that tries to steal your data, and an Add pair button
Pick the question type in the Type field. In a Match pairs question, you enter the terms and their matching answers.

In a Fill in the blanks question, mark a gap with asterisks, for example *12*. Separate several correct answers with a slash, for example *two/2*. Letter case does not matter, but accents do: "cafe" does not match the answer "café". To accept both spellings, write *café/cafe*. When learners pick words from a list, you can add up to 6 extra words that fit no gap.

All types work on a phone and with a keyboard, without dragging.

Steps

  1. On the Lessons step, click Edit quiz next to the quiz or test lesson.
  2. A new quiz opens on the Generate with AI tab. In What is this lesson about (What does this test cover for a test lesson), describe the lesson in one or two sentences, up to 500 characters. The prompt is built from it. While the field is empty, a warning says the AI prompt will be generic.
  3. Set How many questions (3 to 20), then click Generate prompt.
  4. Click Copy prompt, paste it into your AI chat, and run it.
  5. Copy the whole answer and paste it into Paste the JSON from your chat.
  6. Click Import. The editor switches to the Write questions tab - check the questions it loaded. If the editor already had questions, importing replaces all of them after you confirm. Only the questions change: the settings you chose in the editor (shuffling, attempts, pass mark and time limit) stay as they were.
  7. Click Save, or Save and preview to try the quiz right away.
Generate with AI panel in the quiz editor: What is this lesson about filled in with a character counter, How many questions set to 8, the Generate prompt button highlighted, an empty Paste the JSON from your chat box and a greyed-out Import button
Describe the lesson, set the number of questions, then generate the prompt.

You can also add or edit questions by hand on the Write questions tab, without generating them from AI. A quiz that already has questions opens on this tab. The quiz settings and the Save buttons stay visible on both tabs.

Time limit

Set Time limit (minutes) in the quiz settings to give learners 2 to 120 minutes for the whole quiz; 0 means no limit. The start screen tells learners about the limit before they begin, and a clock counts down above each question, with a warning when one minute is left. When the time runs out, the quiz ends on its own: unanswered questions count as wrong, the score is reported to your LMS with the unanswered questions marked as wrong, and the attempt is used up. Reloading the page during a timed quiz keeps the clock running but starts the answers again, so tell learners not to refresh. If your training must meet WCAG, leave the limit at 0 - a time limit is hard for learners who use a screen reader or need more time.

The text on the quiz buttons and messages, such as Start, Check and Try again, can be changed for the whole course: see Change the player labels.

What you should see

The lesson is marked Ready in the lesson list. Save and preview shows the quiz the way a learner will see it.

If something goes wrong

  • Import is greyed out: paste the full JSON answer from your AI chat - an empty box cannot be imported.
  • Save does not save and a red panel appears: the panel lists every problem that blocks saving, for example a question without text or without a correct answer. It shows up the first time you click Save or Save and preview, so a new quiz does not open with a list of errors, and each item disappears as you fix it.
  • The imported quiz has fewer questions than you asked for: rerun the prompt in your AI chat and import again.
  • You need more questions than the quiz allows: a quiz holds up to 12 questions on Free and 40 on Pro. See Free and Pro.

Next

Export the finished course: Export your course to SCORM 1.2.