Table

Use a table when readers need exact record-level values, sorting, and a virtualized window over a governed result set.

Key fields

visuals:
  orders_table:
    type: table
    title: Orders
    query:
      type: records
      dataset: orders
      fields:
      - order_id
      - status
      - revenue
    presentation:
      type: table
      rowHeight: 32
      showHeader: true
      striped: false

Conditional formatting

Bind a closed field or numeric rule to compiled result names. Color-driven categorical outcomes include a redundant icon cue so meaning is not conveyed by color alone. The target field must be one of the visible table columns; a field-rule source may use any field carried by the delivered row.

Key fields

visuals:
  orders_table_conditional:
    type: table
    title: Orders with governed formatting
    query:
      type: records
      dataset: orders
      fields:
      - order_id
      - status
      - revenue
    presentation:
      type: table
      rowHeight: 32
      showHeader: true
      striped: true
      conditionalFormatting:
      - id: status-color
        target: cell_foreground
        field: status
        rule:
          kind: field
          source: status
          values:
            delivered: {color: success, icon: circle}
            shipped: {color: accent, icon: arrow_up}
            canceled: {color: danger, icon: warning}
          nullStyle: {color: neutral}
          defaultStyle: {color: ink, icon: square}
      - id: revenue-gradient
        target: cell_background
        field: revenue
        rule:
          kind: gradient
          minimum: 0
          maximum: 500
          low: {color: neutral}
          high: {color: accent}
          nullStyle: {color: neutral}

API reference

Kind: grid. Renderer: tanstack. Supported result shapes: detail_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.conditionalFormatting`	`closed conditional-format list`	`none`	`gradient` `rules` `field`	Applies governed renderer-neutral styles to compiled result fields with explicit null and default outcomes.
`presentation.rowHeight`	`integer`	`required`	`positive integer`	Sets the tabular row height.
`presentation.showHeader`	`boolean`	`true`	`true` `false`	Shows semantic table headers.
`presentation.striped`	`boolean`	`false`	`true` `false`	Alternates tabular row backgrounds.

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