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: X chip 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, or None) 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 >, >=, <, <=, =, or between (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 between requires 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.

Share