Opinion scale field

Use opinion_scale to collect a point on a numeric scale. Configure the scale’s endpoints and optional labels.

For properties shared by field types, see Shared field properties.

Configuration

Name	Type	Required	Default	Description
`min`	integer	Yes	n/a	First point on the scale. Must be from -100 to 100.
`max`	integer	Yes	n/a	Last point on the scale. Must be from -100 to 100, greater than `min`, with at most 20 points on the scale.
`leftLabel`	string	No	None	Text under the low end of the scale.
`centerLabel`	string	No	None	Text under the middle of the scale.
`rightLabel`	string	No	None	Text under the high end of the scale.

Respondent validation

If the field is required and the respondent has not selected a point, the page is blocked. Clicking the selected point again clears it.

Submission value

The answer is stored as a string containing the selected number. If the respondent clears the selection, the value is an empty string.

{
  "recommend_score": "7"
}

Example

{
  "type": "opinion_scale",
  "name": "recommend_score",
  "label": "How likely are you to recommend us to a friend?",
  "min": 0,
  "max": 10,
  "leftLabel": "Not likely",
  "centerLabel": "Maybe",
  "rightLabel": "Very likely",
  "required": true
}