Quiz Types and Configuration
WittyForm supports five distinct quiz types, each designed for a specific use case. This guide covers the configuration options, scoring mechanics, and ideal scenarios for every type.
Scored Quiz
A scored quiz assigns point values to answers and calculates a total score. Use it for knowledge checks, certification exams, and graded assessments.
How to create
- Create a new form and select Quiz → Scored as the type.
- Add questions and mark correct answers for each.
- Set the point value per question (default is 1 point).
- Optionally configure a passing score threshold.
Configuration options
| Option | Description | Default |
|---|---|---|
pointsPerQuestion | Points awarded for a correct answer | 1 |
passingScore | Minimum score (absolute or percentage) to pass | 70% |
showCorrectAnswers | Reveal correct answers after submission | true |
allowRetakes | Let respondents retake the quiz | false |
timeLimit | Time limit in minutes (0 = no limit) | 0 |
shuffleQuestions | Randomize question order per attempt | false |
When to use
Choose a scored quiz when there are objectively correct answers and you need a numeric grade: employee training quizzes, course assessments, or trivia with a leaderboard.
Personality Quiz
A personality quiz maps answers to traits or outcomes instead of right/wrong scoring. Each answer choice contributes points toward one or more personality outcomes.
How to create
- Create a new form and select Quiz → Personality.
- Define your outcomes (e.g., "Introvert", "Extrovert", "Ambivert").
- For each answer choice, assign trait weights to each outcome.
- Configure result screens with images and descriptions for each outcome.
Configuration options
| Option | Description | Default |
|---|---|---|
outcomes | Array of possible results with title, description, and image | [] |
traitWeights | Per-answer mapping of outcome ID to weight (1 to 10) | 1 |
showTraitBreakdown | Display a breakdown of all trait scores on the result screen | false |
tieBreaker | Strategy when two outcomes tie: first, random, or show_all | first |
When to use
Personality quizzes are ideal for lead generation ("What type of marketer are you?"), product recommendations, and audience segmentation.
Survey
A survey collects responses without scoring. It functions as a standard data collection form but lives in the quiz builder to take advantage of quiz-specific features like progress bars, conditional branching, and analytics.
How to create
- Create a new form and select Quiz → Survey.
- Add any field types (no correct answers needed).
- Configure a thank-you screen.
Configuration options
| Option | Description | Default |
|---|---|---|
showProgressBar | Display a completion progress bar | true |
allowAnonymous | Allow submissions without requiring name/email | true |
oneResponsePerUser | Limit to one submission per user (via cookie or login) | false |
When to use
Use surveys for feedback collection, market research, NPS scores, and any scenario where you need structured data without grading.
Trivia
A trivia quiz is a scored quiz optimized for engagement. Enable instant feedback on individual questions so respondents see whether they got each answer right before they move on. Feedback is per question, so you can enable it on every question, just a few, or none at all.
How to create
- Create a new form and select Quiz → Trivia.
- Add questions with correct answers marked.
- Open each question's editor and toggle Instant Feedback. Customize the correct-answer and incorrect-answer messages.
- Optionally enable Show Correct Answers on the Result Screen block to give respondents a post-quiz review of every question they got wrong.
Configuration options (per question)
| Field | Description | Default |
|---|---|---|
showFeedback | When true, the quiz runner pauses after this question, validates the answer server-side, and shows a correct/incorrect panel before advancing. | false |
feedbackCorrect | Custom message shown on correct answer | "Correct!" |
feedbackIncorrect | Custom message shown on wrong answer | "Incorrect." |
explanation | Shown in the post-submission review when showCorrectAnswers is enabled on the Result Screen block. | none |
Note: When any question in a quiz has showFeedback: true, the Previous button is hidden from that question onward. Once respondents have seen feedback for a question, they cannot go back and change their answer.
When to use
Trivia quizzes work best for fun engagement content, social media quizzes, team-building activities, and gamified learning where immediate feedback keeps users engaged.
Assessment
An assessment uses weighted scoring and competency mapping. Different questions can carry different weights, and results are broken down across competency areas rather than a single total score.
How to create
- Create a new form and select Quiz → Assessment.
- Define competency areas (e.g., "Technical Skills", "Communication", "Leadership").
- Assign each question to a competency area and set its weight.
- Configure score ranges for each competency (e.g., Beginner, Intermediate, Advanced).
Configuration options
| Option | Description | Default |
|---|---|---|
competencies | Array of competency areas with name and description | [] |
questionWeight | Weight multiplier per question (0.5 to 5.0) | 1.0 |
scoreRanges | Per-competency ranges with labels (e.g., 0 to 40 = Beginner) | 3 ranges |
showRadarChart | Display a radar/spider chart of competency scores | true |
generateReport | Auto-generate a downloadable PDF report | false |
When to use
Assessments are ideal for skills evaluations, hiring assessments, 360-degree reviews, and any scenario where you need multi-dimensional scoring across categories.
Comparing quiz types
| Feature | Scored | Personality | Survey | Trivia | Assessment |
|---|---|---|---|---|---|
| Correct answers | Yes | No | No | Yes | Yes |
| Point scoring | Yes | Trait-based | No | Yes | Weighted |
| Instant feedback | Optional | No | No | Yes | Optional |
| Certificates | Yes | No | No | Optional | Yes |
| Leaderboard | Yes | No | No | Yes | Optional |