How do I turn a form page into a graded quiz?

Last updated: September 25, 2026

Turn on the Quiz add-on for a form page to auto-grade the answers and require the employee to pass before they can move on — handy for a forklift safety check or a policy acknowledgment you want to confirm they actually read.

Before you start

  • You can edit forms in your account.

  • The page you want to grade has its question fields built. Quizzes grade text, number, radio, and multi_select fields. Checkbox and dropdown fields can't carry a correct answer, and any other field type is skipped.

How grading works

A quiz is an add-on you turn on for a single form page, not the whole form. Each supported question field gets a correct answer, and when the employee submits the page, Onboarded scores their answers against those correct values. If their score meets the pass threshold, they continue. If it doesn't, the page won't submit and they retry. Scoring is per page too — if a form has more than one quiz page, each one is scored and gated on its own, and there's no combined score across the form.

Text and number fields are compared to the value you set after trimming whitespace, ignoring capitalization. Radio fields match the option you marked correct. Multi-select fields match the full set of options you marked correct, in any order.

What happens when a submission fails

A quiz gates the page — it doesn't route anywhere. When the score lands under the pass threshold the page doesn't submit, and every field the employee got wrong comes back with an Incorrect answer error. With Show correct answer after submit on, that error names the correct value instead. The employee corrects those answers and submits again.

So there's no state where a below-threshold quiz gets handed to an employer to look at. By the time anyone on your side sees the page, the quiz has already passed — any wrong answers still showing are ones the employee missed while still clearing the threshold.

Turn on the quiz

  1. Open the form in the editor and select the page you want to grade.

  2. Turn on the Quiz add-on for that page.

    You should see the Pass threshold and Show correct answer after submit settings appear.

  3. Set the Pass threshold — the percent of questions the employee has to get right to pass, shown with the suffix % correct required. It defaults to 80 and accepts 1–100.

  4. Decide whether to leave Show correct answer after submit on — it's on by default. When it's on, any question the employee got wrong shows its correct answer after they submit — questions they answered correctly aren't annotated. Turn it off for a test where you don't want the answers revealed.

Set the correct answers

  1. Open each question field on the page and set its Correct answer.

  2. Confirm the counter at the bottom of the Quiz panel — it reads {n} questions on this page · {m} with correct answer set. The two numbers should match once every question has an answer.

A question with no correct answer set isn't graded, so it can quietly inflate the pass rate. If employees are passing a quiz they shouldn't, check that counter — a mismatch means a question is missing its answer.

Verify

Preview the form and submit the page with a failing set of answers. The page should refuse to submit and prompt a retry. Submit again with passing answers and confirm the page advances. If Show correct answer after submit is on, the correct answer appears next to each question the employee got wrong.

Review results

After an employee submits a graded page, you can review their answers in the task's field submissions view. Each graded question shows the employee's answer marked Correct or Incorrect, and every question they missed lists the Correct: value beside it — so you can see where someone fell short without re-grading by hand.

Employer review and sign-off

Safety and policy programs often need an employer to confirm the employee understood the material — an OSHA-style sign-off. The Quiz add-on doesn't do that, but a multi-step form does.

One form can interleave pages by assignee: each page is assigned to employee, employer, or system, the pages run in order, and the pending party flips as each page completes. See 📄 How do I build a multi-step form with separate pages for employees and employers? On the employer page, a review field surfaces the employee's earlier answers as a read-only summary — see 📄 How do I display read-only data with a review table? — and a signature field captures the sign-off.

Two limits to plan around. There's no initials field type — signature is the closest, with a require_drawn_signature option when a typed name isn't enough. And an employer can't review answers the employee got wrong, because the quiz blocks the page before it submits. If that's the requirement, leave the Quiz add-on off, collect those questions as ordinary fields, and use an employer review-and-sign page.

Removing a quiz

Turning the Quiz add-on off prompts Remove Quiz add-on? and permanently deletes the quiz and every correct-answer setting for fields on that page. There's no undo, so only remove it if you're sure.

Related