Matrix Question Schema Properties
A single-selection matrix (rows × columns) question.
Element type: matrix
Key properties: 14
Generation Hints
Section titled “Generation Hints”- Aliases: matrix radio, grid question, Likert matrix.
- Use when: respondents choose one column for each row.
- Recommended properties:
type,name,title,rows,columns,isAllRowRequired.
{ "type": "matrix", "name": "satisfaction", "title": "Rate each area", "rows": ["Support", "Product"], "columns": ["Poor", "Good", "Excellent"] }Key Properties
Section titled “Key Properties”- Type:
itemvalue[] - Default:
[]
An array of matrix rows.
columns
Section titled “columns”- Type:
matrixcolumn[] - Default:
[]
An array of matrix columns.
- Type:
cells - Default:
—
An array of matrix cells. Use this array to get or set cell values.
cellType
Section titled “cellType”- Type:
string - Default:
"radio" - Allowed values:
radio,checkbox
Specifies the type of matrix cells.
rowsVisibleIf
Section titled “rowsVisibleIf”- Type:
condition - Default:
—
A Boolean expression that is evaluated against each matrix row. If the expression evaluates to false, the row becomes hidden.
columnsVisibleIf
Section titled “columnsVisibleIf”- Type:
condition - Default:
—
A Boolean expression that is evaluated against each matrix column. If the expression evaluates to false, the column becomes hidden.
rowOrder
Section titled “rowOrder”- Type:
string - Default:
"initial" - Allowed values:
initial,random
Specifies a sort order for matrix rows.
rowTitleWidth
Section titled “rowTitleWidth”- Type:
string - Default:
—
A width for the column that displays row titles (first column). Accepts CSS values.
showHeader
Section titled “showHeader”- Type:
boolean - Default:
true
Specifies whether to display the table header that contains column captions.
alternateRows
Section titled “alternateRows”- Type:
boolean - Default:
false
Specifies whether to apply shading to alternate matrix rows.
eachRowRequired
Section titled “eachRowRequired”- Type:
boolean - Default:
—
Specifies whether each row requires an answer. If a respondent skips a row, the question displays a validation error.
eachRowUnique
Section titled “eachRowUnique”- Type:
boolean - Default:
—
Specifies whether answers in all rows should be unique. If any answers duplicate, the question displays a validation error.
hideIfRowsEmpty
Section titled “hideIfRowsEmpty”- Type:
boolean - Default:
—
Specifies whether to hide the question when the matrix has no visible rows.
verticalAlign
Section titled “verticalAlign”- Type:
string - Default:
"middle" - Allowed values:
top,middle
Aligns matrix cell content in the vertical direction.
Shared Properties
Section titled “Shared Properties”This page lists only properties that are specific to this element type or especially important for generation.
- Use Shared Question Properties for common fields such as
name,title,description,isRequired,requiredIf,visibleIf,enableIf,readOnly,defaultValue,validators,width, and layout options. - Use Matrix Row and Matrix Column for
rowsandcolumnsobject shapes.