Building quizzes and assessments

Overview

A StretchCode quiz (an assessment) is a course-level, multiple-choice test that verifies learners actually absorbed the material. Passing every published quiz is required to complete a course and earn its certificate. Grading is done server-side, and correct answers are never sent to the learner's browser before they submit.

How quizzes work

• A quiz attaches at the course level (commonly titled Final Quiz).
• Each quiz has a set of questions, each with a prompt, a list of options, one correct option, and an optional explanation shown after submission.
• Each quiz has a pass threshold — the minimum score percentage to pass. The default is 70%.
• Learners can attempt a quiz multiple times; StretchCode tracks each attempt and remembers the learner's best score and whether they've passed.

Create a quiz

1. Open the course in the builder and go to its Quiz area.
2. Add a quiz, give it a title (for example, Final Quiz), and set the pass threshold (for example, 80%).
3. Add questions. For each: write the prompt, list the answer options, mark the correct option, and (recommended) add an explanation that will show learners why the answer is right.
4. Set the quiz status to published when it's ready. A draft quiz does not appear to learners and does not gate completion.
5. Save. The course page now shows a "Take the final quiz" call to action for enrolled learners.

Scoring and passing

When a learner submits:

1. StretchCode compares each answer to the correct option and counts correct responses.
2. The score is correct ÷ total questions, rounded to a percentage.
3. If the score meets or exceeds the pass threshold, the attempt is marked passed.
4. The learner sees their score, which questions they got right or wrong, and the explanations.
5. The attempt is recorded, and the learner's best result is updated.

Example: a 10-question quiz with an 80% threshold. A learner answers 9 correctly → 90% → passed. Another answers 7 → 70% → not passed; they retake it and improve.

Quizzes gate completion

Completion requires all published lessons complete AND all published quizzes passed. So a learner who finishes every lesson but hasn't passed the quiz will see 100% lesson progress while the course stays incomplete — and no certificate is issued — until they pass. The moment they pass, the certificate is issued automatically.

A realistic example

Workplace Safety has eight lessons and one published final quiz at 75%. An employee completes all eight lessons (progress shows 100%) but the course is still incomplete. They take the quiz, score 62%, review the explanations, retake it, and score 88% — the course flips to complete and certificate SC-77C1A0E4B9 is issued. Their best score (88%) is retained.

Tips

• Always add explanations — they turn a quiz into a teaching moment and reduce repeat failures.
• Set the threshold to match the stakes: 70% for general knowledge checks, higher for compliance or certification.
• Keep a quiz in draft until its course content is finished; a published quiz immediately becomes part of the completion requirement.
• Because retakes are allowed and the best score is kept, learners can improve without penalty — good for learning, but set a higher bar if you need rigor.

Troubleshooting

Learners can't find the quiz. The quiz must be published, and the learner must be enrolled. Enrolled learners see a "Take the final quiz" action on the course page.

A learner finished all lessons but has no certificate. They still need to pass the published quiz. Lesson completion alone doesn't complete a quiz-gated course.

Do learners ever see the correct answers early? No. Correct answers stay server-side and are only revealed (with explanations) after a submission.