Docs

Scoring Logic

QuizFlow Labs lets you treat certain question responses as scored inputs so you can tally a total, surface it on completion, and route people into different completion outcomes.

Question-level scoring

  • Enable scoring for Multiple Choice, Choice Buttons, Yes/No, or Scale questions to assign integer points. Scoring is billed on any paid plan (Basic, Pro, Team) and toggles independently for each question.
  • Multi-select questions sum every selected option score. Choice buttons mirror 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 completion step and lets you drop {"{{total_score}}"} into any completion 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.
  • Completion copy inherits {{total_score}} automatically when you opt to show it, and the same value is used when evaluating score-based rules.
  • Use the completion step to control whether respondents see the total and whether the full response list appears on the report card.

Completion rules

  • Pro/Team plans can add score-based completion rules that evaluate >, >=, <, <=, =, or between (inclusive) ranges.
  • Rules run top-to-bottom and stop at the first match, so order the tightest ranges first. Each rule can override the completion title and message, and both can include {{total_score}}.
  • Rule 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 rule matches, the base completion title/message renders (still honoring the Display total score and Display responses toggles).
  • On non-Pro plans the completion rules UI shows an upgrade hint and keeps the controls disabled until you move to an eligible plan.

Tips

  • Score every option intentionally—zero is treated as “scoring enabled” and contributes to the total.
  • Preview the quiz or check the completion step to confirm the {{total_score}} placeholder resolves as expected.
  • Combine Jump Logic with scoring carefully, since skipped questions never count toward completion rules or totals.
  • Use the {{tag:<questionId>}} or {{tags:<questionId>}} placeholders to echo response tags in completion copy; the Response Tags guide explains how those placeholders resolve and how tags flow into submissions.