Checkbox Widget
Use a single checked or unchecked state for true-false, acknowledgement, and simple confirmation tasks.
The checkbox widget is a compact true-or-false control. It works well when the task is binary and does not need a full multiple choice layout.
Select the checkbox on the canvas and click the floating ⚙ Configure button to open its setup dialog — the label, starting state, and answer key all live there. See Configuring a Checkbox for the full walkthrough.
Settings to know
- Label is the statement learners respond to.
- Double-click the checkbox on the canvas to edit the label in place, or use the Label field in the Configure dialog.
- Default Checked controls whether the box starts checked.
Sizing a checkbox
A checkbox is a row: a box, a gap, and the label beside it. You set how wide that row is, and its height takes care of itself.
- Drag a corner to scale the whole row. The label, the box, and the spacing between them all grow or shrink together, and a badge shows the text size while you drag.
- Drag a side handle (the tall pill on the left or right edge) to set the width. The text size stays put; a long label wraps onto more lines and the row gets taller to fit.
- Height looks after itself. The row is at least as tall as its label needs (and never shorter than a comfortable tap target). Type a longer label and the row grows. If you want a bigger tap area — handy for young learners — set a taller height and the row keeps it; editing the label won't collapse it back.
- Prefer the keyboard? The Width field under _Show more options_ does the same job as the side handles, and the Font Size field does the same job as a corner drag.
Long labels used to be cut off with an ellipsis when they outgrew the box. They now wrap instead, so nothing a learner needs to read can disappear.
Checkboxes you made before this change
Existing checkboxes keep their exact look — same size, same single-line label — until you edit them. The moment you change the label or the width, the row switches to automatic height and starts wrapping.
If you want to switch one over without changing anything else, open Show more options and click Use automatic sizing. Undo puts it back if you change your mind.
Deliberately tall checkboxes are safe: if you made one into a big tap card, it keeps that height when it switches over, and keeps it through later label edits.
Grading setup
Checkbox supports grading. The grading controls are in the Scoring section of the ⚙ Configure dialog.
- Scoring (the On/Off switch at the top of the section) turns grading on or off for the checkbox.
- The widget's name is the readable label for this answer in results and conditions. Rename it at the top of the properties panel — see Widgets and widget settings.
- Points sets how much the checkbox is worth.
- While Scoring is on, the checkbox counts toward both the scene score and the lesson score.
- Group lets you include the checkbox in a custom grading group.
- Correct value decides whether checked or unchecked counts as correct.
A box the learner leaves alone
A checkbox always shows an answer, even before anyone touches it — it starts checked or unchecked. When the lesson is graded, a box the learner never clicked counts as its starting state. So a statement learners should leave unchecked earns its points without a click, and ticking it then unticking it scores exactly the same as leaving it alone.
Leaving a box alone is not the same as answering it, though: Is answered stays false until the learner clicks the box, and On correct does not fire for a box nobody touched.
How to set up the content
Write the label as a complete statement the learner can agree or disagree with by checking it. If you are using it for acknowledgement instead of correctness, leave grading off.
Useful setting combinations
- Default unchecked + Correct value checked:
Best for statements learners must agree are true.
- Default unchecked + Correct value unchecked:
Best for spotting a false statement. Learners who correctly leave it alone get the points.
- Several checkboxes, some Checked and some Unchecked, and one Submit button:
Best for "Tick every sentence that is true". Step-by-step: Tick every true sentence with checkboxes.
- Checkbox + a widget that reads Checked:
Best for opt-in choices such as I want a hint. Turn Scoring off, then set the hint's visibility Mode to Conditional with Behavior set to Show, and a condition that your checkbox's Checked is true. The hint appears the moment the box is ticked and hides again when it is unticked. See Visibility and Personalization.
- Checkbox + conditional visibility:
Best for showing a follow-up only after learners make a commitment.
Strong use cases
- True-false checks.
- Safety or directions acknowledgement.
- "I am ready to continue" confirmations.
Great pairings with other widgets
- Pair a checkbox with button to unlock continue only after acknowledgement. Step-by-step: Unlock a button when every checklist box is ticked.
- Pair it with text to show a reflection statement or rule.
- Pair it with image when learners verify something visible in the visual.
- Pair it with score if it is part of a larger graded scene.