Matrix

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

Key fields

visuals:
  status_matrix:
    type: matrix
    title: Orders by category and status
    query:
      rows:
        category: orders.category
      columns:
        status: orders.status
      measures:
        order_count: null
        revenue: null

API reference

Kind: visual. Renderer: tabular. Supported result shapes: matrix.

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 measure fields.
`cardinality`	`string`	—	`bounded` `exact`	Controls whether the visual resolves an exact row count.

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