Matrix Column Schema

Matrix column objects define the fields shown across each row in matrixdropdown and matrixdynamic questions.

Minimal Shape

{
  "name": "quantity",
  "title": "Quantity",
  "cellType": "text",
  "inputType": "number",
  "isRequired": true
}

Properties

name

• Type: string
• Required: Yes

Stored key for this column inside each matrix row value.

title

• Type: string
• Localizable: Yes

Visible column label.

cellType

• Type: string
• Allowed values: dropdown, checkbox, radiogroup, tagbox, text, comment, boolean, expression, rating, slider

Question type used inside cells for this column. Overrides the matrix-level cellType.

choices

• Type: choiceitem[]

Choices for dropdown, checkbox, radiogroup, or tagbox cells.

inputType

• Type: string

Input type for text cells, for example text, number, email, or date.

isRequired

• Type: boolean

Requires a value in this column.

visibleIf

• Type: condition

Controls column visibility.

Example

{
  "type": "matrixdynamic",
  "name": "lineItems",
  "title": "Line items",
  "columns": [
    { "name": "item", "title": "Item", "cellType": "text", "isRequired": true },
    { "name": "quantity", "title": "Quantity", "cellType": "text", "inputType": "number" },
    {
      "name": "priority",
      "title": "Priority",
      "cellType": "dropdown",
      "choices": ["Low", "Medium", "High"]
    }
  ]
}