Skip to main content
Rating questions collect quantitative feedback on a numeric or symbolic scale. There are four types, each suited to a different kind of measurement.

Star rating

Respondents click stars to rate something. The most familiar rating format — best for product ratings, satisfaction surveys, or anything where star ratings are culturally understood. Star rating question in the canvas
FieldTypeDefaultNotes
max_starsNumber5Total number of stars (1–10)
allow_halfBooleanfalseAllows selecting half-star increments
default_ratingNumber0Pre-selected rating (0 = none, up to max_stars)
icon_styleTextIcon character used for the stars
active_colorColor#facc15Color of selected stars
inactive_colorColor#e5e7ebColor of unselected stars
dynamic_labelsBoolean / Arraynull (off)Per-star labels (array length = max_stars)
label_lowTextLabel shown at the low end (when dynamic labels are off)
label_highTextLabel shown at the high end (when dynamic labels are off)
label_positionEnumtop or bottom — where labels appear relative to the stars

Number scale

Respondents click a number on a scale. Supports multiple visual styles and colour templates.
FieldTypeDefaultNotes
minNumber0Lowest value on the scale (min 0)
maxNumber10Highest value on the scale (max 20)
styleEnumbuttonsVisual style (see below)
starting_valueNumber0Pre-selected value (applicable for slider and colour styles)
dynamic_labelsBoolean / Arraynull (off)Per-number labels (array length = (max − min) + 1)
label_lowTextLabel at the low end (when dynamic labels are off)
label_highTextLabel at the high end
label_positionEnumtop or bottom
Style options:
StyleDescription
buttonsPlain numbered buttons in a row
sliderA draggable slider
style-templateColoured buttons using a predefined colour template
style-customColoured buttons with custom selected, hover, and unselected colours
Colour templates (when style is style-template):
TemplateDescription
traffic-lightRed → yellow → green gradient
heat-mapBlue → red gradient
monochromeSingle-colour gradient
Custom colours (when style is style-custom):
FieldDefault
selected_color#3b82f6
hover_color#bfdbfe
unselected_color#f3f4f6

Emoji rating

Respondents click an emoji to express their sentiment. Best for quick mood checks, satisfaction snapshots, or anywhere a visual, informal tone fits. Emoji rating question in the canvas
FieldTypeDefaultNotes
optionsList5 emojis (😡→😄)Each option has an emoji glyph and a label
selected_colorColor#3b82f6Highlight color for the selected emoji
unselected_colorColor#f3f4f6Background color for unselected emojis
show_labelBooleantrueShows the label beneath each emoji
orientationEnumhorizontalhorizontal or vertical layout
Options can be edited individually or replaced with a preset template from the template picker in the right panel.

Opinion scale

A horizontal scale from a low to high value. Best for NPS surveys, agreement scales, or likelihood questions.
FieldTypeDefaultNotes
minNumber0Lowest value (0–5)
maxNumber10Highest value (5–20)
starting_valueNumberPre-selected value
selected_colorColor#3b82f6Color of the selected value
unselected_colorColor#f3f4f6Color of unselected values
dynamic_labelsBoolean / Arraynull (off)Per-value labels (array length = (max − min) + 1)
label_lowTextNot likelyLabel at the low end
label_highTextVery likelyLabel at the high end
For a standard NPS survey, set min to 0 and max to 10, with label_low = “Not at all likely” and label_high = “Extremely likely”.

Next steps

Advanced questions

File upload and Matrix.

Scoring

Assign point values to rating answers and track a total score.