Result breakdown block

Use the result_breakdown block to show a quiz review after submission. It collects no answer.

What it shows

The block can show the total score, correct answers and per-question explanations. Explanations come from each question's answer_explanation. You can also show a retry button, play a celebration effect, or start with the answer list collapsed. Set show_correctness to false for a neutral review without right/wrong marks or a score.

The block shows nothing when the form has no scored question to review. Place it on an ending page. For a reviewable question, the form needs at least one single-answer choice question with exactly one positive-scoring option and zero for every other option.

Configuration

Unknown properties are rejected.

PropertyTypeRequiredDefaultAllowed values / rangeDescription
typestringYes—result_breakdownSelects the block.
show_scorebooleanNotruetrue, falseShows the total score. It is not shown when show_correctness is false.
show_correct_answersbooleanNotruetrue, falseShows the correct answer for each question.
show_explanationsbooleanNotruetrue, falseShows each question's answer_explanation.
retry_actionstringNoreloadreload, nonereload shows a retry button that starts the form again; none hides the button.
celebratebooleanNofalsetrue, falsePlays the celebration effect on the ending.
collapsedbooleanNofalsetrue, falseStarts the answer list behind a show/hide toggle.
show_correctnessbooleanNotruetrue, falseWhen false, shows a neutral review with no right/wrong marks and no score.
visible_if, hide_ifcondition arrayNoNoneSame condition syntax as fieldsControls whether the block is shown or hidden.

If the block is outside an ending page or the form has no reviewable questions, the draft can save, but publishing fails with 400 INVALID_RESULT_BREAKDOWN.

Where to use it

Use this block for a quiz review after the respondent submits the form. It has no submission value because it does not collect an answer.

JSON example

This form places the review on its ending page and gives one answer a positive score and the other answer a score of zero.

{ "mode": "page", "pages": [ { "type": "form", "id": "p1", "ui": [ { "type": "multiple_choice", "name": "capital", "label": "What is the capital of France?", "options": ["Paris", "Lyon"], "scoring": [1, 0], "answer_explanation": "Paris is the capital of France." } ] } ], "end": [ { "id": "e0", "type": "end", "ui": [ { "type": "result_breakdown", "show_score": true, "show_correct_answers": true, "show_explanations": true, "retry_action": "reload", "celebrate": true, "collapsed": false, "show_correctness": true } ] } ] }