Matrix

Use a matrix for grouped rows and metrics, optionally split across a column dimension.

Key fields

visuals:
  status_matrix:
    type: matrix
    title: Orders by category and status
    query:
      type: pivot
      rows:
      - category
      columns:
      - status
      metrics:
      - order_count
      - revenue
    presentation:
      type: table
      rowHeight: 32
      showHeader: true
      striped: false

Conditional-format targets may name visible row fields or metric aliases. Column dimensions are used to generate the cross-tab headers and are not visible target columns.

API reference

Kind: grid. Renderer: tanstack. Supported result shapes: matrix_window.

Field	Type	Default	Allowed values	Description
`type`	`string`	—	`table` `matrix` `pivot`	Selects the tabular visual behavior.
`query`	`tabular query`	—	—	Selects record fields or grouped row, column, and metric fields.
`cardinality`	`string`	—	`bounded` `exact`	Controls whether the visual resolves an exact row count.
`presentation.rowHeight`	`integer`	`required`	`positive integer`	Sets the tabular row height.
`presentation.showHeader`	`boolean`	`true`	`true` `false`	Shows semantic table headers.

Accessibility. Tabular visuals expose semantic headers and virtualized rows while preserving keyboard navigation.