Single-Select Matrix

Matrix table questions combine multiple survey questions with identical answers. They are useful when you need to ask respondents to rate statements on the same scale. A good matrix table question example is a Likert scale survey question (also known as a satisfaction scale). It allows respondents to describe their attitude to certain statements on a 5 to 7-point scale or answer several close-ended questions with the same choice options. If you want to allow only one scale point per statement to be selected, use a single-selection matrix question. This question displays statements in the form of a grid with radio buttons. This demo shows a matrix table survey question example and describes how to configure a single-choice matrix question.

To add a single-answer matrix to your survey, create an object with the type property set to "matrix" and add the object to the elements array. Configure statements in the rows array, and matrix answer choices (scale points)—in the columns array. Both arrays accept objects with the following structure:

{
  "value": any, // A value to be saved in the survey results
  "text": String, // A display text. When `text` is undefined, `value` is used.
}

Statements (rows) and scale points (columns) have the same sort order as their objects in the rows and columns arrays. To reverse the order of a matrix table scale, reorder the corresponding objects.

If you want users to rate all statements, enable the isAllRowRequired property. In this case, the matrix question produces a validation error if at least one statement is left unrated.

This demo also shows how you can alternate the color of rows. Set the alternateRows property to true to enable this functionality.