Docs
Scoring Logic
Published July 25, 2026
QuizFlow Labs lets you treat certain question responses as scored inputs so you can tally a total, surface it in the outcome, and route people into different outcomes.
Question-level scoring
- Enable scoring for Multiple Choice, Dropdown, Choice Buttons, Yes/No, or Scale questions to assign integer points. Scoring is available on Basic+ plans and toggles independently for each question.
- Multi-select questions sum every selected option score. Dropdown and Choice Buttons mirror single-select Multiple Choice scoring. Scale responses contribute their raw numeric answer, and Yes/No exposes separate fields for yes and no values.
- Scores must be whole numbers between -9,999 and 9,999. The builder truncates decimals and clamps any submitted value outside that range, and missing scores default to 0 when scoring is active.
- Only questions that were shown and answered increment the total; skipped questions (due to Jump Logic or other routing) stay out of the tally.
- Turning on scoring also enables the Display total score checkbox in the Outcomes and lets you drop
{"{{total_score}}"}into any outcome copy. The placeholder is stripped from the rendered text if the toggle is off or if no score is shown.
Total score behavior
- The total score is the sum of every scored choice in answered questions plus the numeric value entered on enabled scale questions.
- Outcome copy inherits
{{total_score}}automatically when you opt to show it, and the same value is used when evaluating score-based rules. - Use the Outcomes to control whether participants see the total and whether the full response list appears on the report card.
- If you want participants to see score updates before the outcome, enable Running score in Appearance → Modality & Experience. The flow will show a live
Score: Xchip during scored questions without changing outcome rules.
Immediate answer feedback
- For questions that support Answer Key (Multiple Choice, Choice Buttons, Yes/No, Text), you can optionally enable Immediate feedback so participants see right/wrong confirmation right after they answer.
- Feedback depends on answer keys: if no answer key is set for a question, immediate feedback cannot evaluate correctness for that question.
- Builders can configure correct and incorrect states independently (
Check,X,Not quite,Custom text, orNone) and choose animation style (Subtle,Playful,None). - Immediate feedback does not change scoring rules or outcome rule evaluation; it is a participant UX layer on top of existing scoring behavior.
Score-based Conditional Outcomes
- Pro plans can add score-based Conditional Outcomes that evaluate
>,>=,<,<=,=, orbetween(inclusive) ranges. - Score remains disabled in the condition chooser until scoring is enabled on at least one question. This setup state is different from a plan lock.
- Score conditions run top-to-bottom within their type and stop at the first match, so order the tightest ranges first. Each outcome can override the outcome title, message, and actions; its copy can include
{{total_score}}. - Condition values are treated as integers within the same -9,999 to 9,999 bounds, and
betweenrequires a smaller min than max; the builder enforces these constraints automatically. - If no score condition matches, the default outcome renders and still honors Show total score and Show submitted responses.
- On non-Pro plans the condition options show clickable lock icons. Selecting one opens an explanation with an Upgrade to Pro action.
Tips
- Score every option intentionally—zero is treated as “scoring enabled” and contributes to the total.
- Preview the quiz or check the Outcomes to confirm the
{{total_score}}placeholder resolves as expected. - Turn on Running score in Appearance when you need test-style feedback during the quiz, and leave it off for lead-gen or assessment flows where you only want to reveal scores at completion.
- Combine Jump Logic with scoring carefully, since skipped questions never count toward outcome rules or totals.
- Use the
{{tag:<questionId>}}or{{tags:<questionId>}}placeholders to echo response tags in outcome copy; the Response Tags guide explains how those placeholders resolve and how tags flow into submissions.
For a complete workflow, see How to build a product recommendation quiz.

