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

Last updated: June 29, 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 — other field types are 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.

Text fields are graded on an exact match, ignoring capitalization. Radio, multi-select, and number fields are graded against the value you set.

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. It defaults to 80 and accepts 1–100.

  4. Decide whether to leave Show correct answer after submit on. 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 · {n} 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.

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