Add a quiz to a lesson, choose its question types and set how learners pass it. This guide is for course providers creating quizzes in on-demand or blended courses. For submitted work, use View Quiz Results and Mark Answers.
Course and permission needed: Quizzes are available in On-demand online course and Blended course lessons. System Admins and Course Owners can edit course content. Facilitators cannot open the course editor.
A quiz contains one or more questions inside a lesson. Learners submit those answers together as a quiz response. Editing course content and reviewing an assigned response are separate permissions.
Add a quiz to a lesson
Type /q in the lesson editor and choose Quiz. The populated card shows sample settings, not defaults.
Go to admin.cademy.io and select Courses. Open the intended on-demand or blended course and select Edit Course.
Open Contents, then open an existing lesson. To create a lesson first, follow the lesson guide linked below.
In an empty lesson, select Quiz. If the lesson already has content, type / on an empty line and select Quiz. Select Edit Quiz on its card.
Enter a quiz title. Select Add Question, choose the question type and enter its question and answer details.
Open the question’s Question Settings sliders button for its answer rules, description, feedback or notes. For Multiple Choice with several correct options, enable Allow multiple answers before marking those options. Select Done to apply the settings.
For Multiple Choice, use Mark as Correct on the intended correct options. Then use Mark as Incorrect on any preselected option that should not be accepted. A new question initially marks Option 1 correct; at least one option must remain correct.
Repeat for each question. Use a question’s drag handle to change its position.
Select Quiz Settings. Configure grading, attempts, completion and notifications as described below, then select Done.
Select the main Save. It saves the quiz, its parent lesson and pending course changes. Reopen the saved quiz and check its questions and settings. If a save reports an error, check what was saved before repeating the change.
Select Edit Quiz on the quiz card.
Use the sliders button to open Question Settings. Select the circle beside an option to mark it correct.
For sections, lessons, other content blocks, saving and publishing, read Build Lessons and Organise Course Content.
Choose a question type from Add Question. Select Manual in Quiz Settings when a person must review Long Text or File Upload answers.
Choose a question type
Add Question offers five question types. The Marking setting determines whether answers wait for manual review.
For ordinary questions created in this editor, the learner must complete every answer before selecting Submit Answers. A File Upload answer also needs its uploads to finish and the required number of files. An enabled Submit Answers button does not confirm that the answers were submitted successfully.
Multiple Choice: enter the answer options. For more than one correct option, open Question Settings and turn on Allow multiple answers first. Answer Is Correct When offers All Correct Options Selected, then Any Correct Option Selected. Select Done, mark the intended options correct, then unmark an unwanted preselected option. With multiple answers off, selecting another correct option replaces the previous one. Selecting an incorrect option makes a multiple-answer response incorrect under either matching rule.
Short Answer: enter the Correct Answer. In Question Settings, Answer must match exactly makes case and internal characters matter; leading and trailing spaces are still ignored. With it off, matching ignores case and removes characters other than the letters A–Z. Use exact matching when punctuation, digits or accented letters must distinguish answers; use Number for a numerical answer.
Number: enter the Correct Answer. In Question Settings, use Tolerance to allow a range. For example, a correct answer of 10 with tolerance 2 accepts answers from 8 to 12, inclusive.
Long Text: in Question Settings, set Minimum Word Count, Maximum Word Count and optional Answer Placeholder. Automatic marking checks its word-count rules; manual submissions still need a person to assess the answer and its length.
File Upload: in Question Settings, add Upload Instructions, then set Minimum Number of Files, Maximum Number of Files and Maximum File Size (MB). The size limit applies to each file. Select Done after changing the question settings.
Each question can include an optional Description. For File Upload, this field is called Upload Instructions.
In Question Settings, an Internal Note gives guidance to people reviewing the submission. They open it under Marking notes; learners do not see it. Delete Question removes that question from the quiz. Review existing responses before structural question changes, as explained in the editing section below. Select Done to apply other settings, then the main Save to keep the quiz changes.
Use Question Settings for answer rules, feedback and an internal note. Select Done, then save the quiz.
Feedback When Correct and Feedback When Incorrect are available for Multiple Choice, Short Answer and Number questions. These are fixed messages that learners see with the marked result.
After an automatically marked submission, the learner sees the fixed feedback for each question and the overall result.
Choose how the quiz is marked
Choose grading, retakes and completion requirements in Quiz Settings. The values shown are sample settings.
Open Quiz Settings. Under Grading, set Pass Mark and use Marking to choose one of these options. Select Done after changing settings, then the main Save.
Automatic Where Possible: Cademy checks Multiple Choice, Short Answer and Number answers against the rules you set, then shows the marked result after a successful submission. It saves a response but does not create an Inbox conversation for manual review. The learner sees Quiz Passed or Quiz Failed with their score under the quiz in the lesson. To read the response yourself, follow View Quiz Results and Mark Answers.
Manual: the whole submitted quiz waits for review. The learner sees Answers Submitted until an authorised reviewer marks it.
Long Text and File Upload with automatic marking: Cademy does not judge the meaning or quality of these answers. Automatic Where Possible accepts a Long Text answer that meets its word-count rules and a File Upload answer that meets its file rules. Choose Manual when a person must assess their content.
Set scoring and retakes
Pass Mark: enter a percentage from 0 to 100. Automatic marking gives each question equal weight. The learner passes when their score, rounded to a whole number, meets or exceeds this percentage.
Manual marking: the reviewer marks answers correct or incorrect. Cademy calculates a score, but the reviewer chooses the overall Mark as Not Passed or Mark as Passed result.
Allow Retakes: enable it to offer further attempts after failure while the chosen limit permits. The options are Unlimited, Up to 1, Up to 2, Up to 3, Up to 5 and Up to 10. A numbered limit counts failed submitted attempts, including the first failure; it is not that many extra retries. In particular, Up to 1 leaves no retry after the first failure, although the learner’s quiz header reads “1 retake allowed”. A learner who has passed cannot keep answering the same submission.
After a failed attempt, the learner sees the remaining attempt allowance when another attempt is available. Once the limit is reached, the quiz shows a maximum-attempts message instead. Check a saved quiz’s actual settings; a new quiz starts with automatic marking, a 50% pass mark and unlimited retakes.
Control lesson completion and failure notifications
Required to Complete the Lesson: the learner must pass this quiz before completing the lesson. A manual submission waiting for review is not a pass. Other required content or access conditions can also prevent completion.
Notify Me When a Student Fails: emails the course’s assigned facilitators after a failed attempt when this option is enabled. It is not an email only to the person who enabled the setting. The email is sent again each time you save Mark as Not Passed on a response.
Require the quiz when submission is part of the lesson. A new quiz has Required to Complete the Lesson switched off. With it off, the quiz itself does not require the learner to submit before completing the lesson. Cademy attempts to save draft answers when the learner leaves a question; learners should check the Answers last saved status. Draft answers are not submitted work available for manual review.
Preview and test the quiz
Select Preview as Student to inspect the saved quiz layout.
Save the course at least once, then open Courses > course > Edit Course > Contents and the intended lesson or quiz.
Select Preview as Student from Contents, the lesson editor or the Quiz editor.
If Save Before Previewing? appears, choose Cancel to stay in the editor, Preview Without Saving for the saved version, or Save & Preview to save pending changes first.
Check the saved questions and layout in the preview. A Draft lesson can be shown here even though ordinary learners cannot access it.
Admin preview does not submit the quiz.
The quiz shows Previewing as admin. Responses are disabled. Use it to check how the quiz looks, but not submission, automatic marking, manual review, retakes or saved progress.
Admin preview shows the layout. It does not test submissions or saved learner progress.
To test the complete flow with a real learner Registration, follow Test a Course Before Launch.
View quiz results and mark answers
Open the course’s Progress tab and select the quiz beneath its lesson. View Quiz Results and Mark Answers explains result views, answer marking, feedback, saved-result emails and exports.
Find quiz attempts on a learner’s Registration
From a learner’s Registration, expand Progress, expand the lesson’s section and select the quiz’s name. The dialog groups submitted attempts for that quiz. For the full steps and Inbox alternative, see View Quiz Results and Mark Answers.
Edit or delete a quiz
Use the trash button on the Quiz block to remove it, then select Save and review any deletion confirmation.
To edit, open Courses > course > Edit Course > Contents, open the lesson and select Edit Quiz. Apply changes in Question Settings or Quiz Settings with Done, then select the main Save. Reopen the quiz to check the saved result.
Review previous submissions before changing the questions. The marking view uses the quiz’s current questions. Editing a question changes what the reviewer reads, and removing an individual question can hide its old answer from that view even though the submitted response still exists. Review or download the response files you need before structural question changes.
Open Courses > course > Edit Course > Contents and the intended lesson. Identify the Quiz block you want to remove.
Point to the Quiz block and select its trash button, labelled Delete block. You can also open the block’s drag-handle menu and select Delete. Then select the lesson’s Save. This is different from Delete Question inside the quiz editor.
For a previously saved quiz, Delete Quiz? asks you to check the quiz name. It warns that saving the lesson will permanently delete the quiz and its questions, and says that responses students have already submitted are kept. Select Cancel to stop, or Delete Quiz & Save to confirm. If several saved quizzes were removed, the dialog is Delete Quizzes? and the confirmation is Delete Quizzes & Save. Removing a newly added, unsaved Quiz block does not need this confirmation.
Reopen the saved lesson to check that the block is gone. If the lesson saved but a quiz could not be deleted, follow the displayed warning and contact Cademy Support if the saved state is unclear; do not assume the whole save failed.
Removing a Quiz block keeps submitted responses. In this editor, its saved quiz data is retained for reviewing those responses. If another lesson still uses the quiz, it remains available there. This guidance covers removing a Quiz block in this editor. Before deleting the whole lesson or course, check with Cademy Support if you need to keep access to previous submissions. Review the responses and download any uploaded files you need before selecting Delete Quiz & Save. Once no published lesson in the course has a quiz, the Registration no longer lists quiz submissions. Manual responses still open from the Inbox, and the saved data is kept.
Frequently asked questions
Why can I not add a Quiz?
Check that the course is an On-demand online course or Blended course, and that you have System Admin or Course Owner access to it. Open a lesson from Edit Course > Contents, then type / on an empty main lesson line and select Quiz.
Why did a Long Text or File Upload answer pass without being reviewed?
The quiz is using Automatic Where Possible. These answers are accepted as correct when they meet the word-count or file rules. Change Marking to Manual if a person must review them.
Where can I find submitted quiz answers?
Open the course’s Progress tab and select the quiz, or open the learner’s Registration and expand Progress. Automatic marking does not create an Inbox conversation. View Quiz Results and Mark Answers explains these routes and missing submissions.
Why can the learner not select Submit Answers?
Every question must have an answer. For File Upload, the learner must finish uploading the minimum number of files.
Why did Cademy reject the submission after the learner selected Submit Answers?
For automatic marking, check Long Text word-count limits. For either marking method, check completed uploads, the permitted number of files and each file’s size. An enabled Submit Answers button is not confirmation of successful submission. If valid-looking answers are rejected, contact Cademy Support with the course, lesson, question type and exact error; avoid sending confidential answer contents.
Why can the learner not continue to the next lesson?
If Required to Complete the Lesson is on, the learner must pass the quiz; a pending manual response still needs marking. After passing, the learner uses Complete & Continue, or Mark as Completed on the final lesson, when all the lesson’s other requirements are met. A missing or locked lesson can also involve separate access or schedule conditions.
Why can I not submit answers in Preview as Student?
Quiz responses are disabled in admin preview. Follow Test a Course Before Launch to test submission, marking, retakes and saved progress.
Can I reuse a quiz in another lesson?
There is no separate Quiz library. Save the original lesson first, then use the lesson’s Duplicate for the same course or Copy to Course… for another on-demand or blended course. Those operations create separate copies of its available quizzes. Duplicating or copying and pasting a Quiz block is different and can keep the same quiz. Check the resulting Draft before publishing. See Build Lessons and Organise Course Content for the complete lesson-copying steps.
Can I reset a learner’s quiz attempts?
There is currently no self-service reset control. A learner can submit another attempt only while retakes remain. Contact Cademy support for advice if the learner has no attempts left.