Combo chart

Use a combo chart when related measures need different visual encodings.

Every preview on this page is generated from the YAML shown below it using a fixed documentation dataset.

Multiple measures

Select multiple query.measures to render related values against the same category axis. The combo shape assigns each measure its own series.

Key fields

visuals:
  revenue_orders_combo:
    title: Revenue and orders by month
    description: Compares monthly revenue and order volume together.
    type: combo
    presentation:
      series_types:
        Revenue: line
        Orders: column
    query:
      dimensions:
        purchase_month: orders.purchase_month
      measures:
        revenue: null
        order_count: null
      sort:
        - field: purchase_month
          direction: asc
      limit: 30

Per-series renderers

Use presentation.series_types to render review score as a line and delivery days as columns while retaining one shared status axis.

Key fields

visuals:
  review_delivery_combo:
    title: Review and delivery by status
    type: combo
    presentation:
      series_types:
        Review: line
        Delivery days: column
    query:
      dimensions:
        status: orders.status
      measures:
        review_score: null
        delivery_days: null
      sort:
        - field: status
          direction: asc

Dual axes

Enable presentation.dual_axis when the measures use different scales, then assign line and column marks explicitly with series_types.

Key fields

visuals:
  revenue_orders_dual_axis_combo:
    title: Revenue and orders dual-axis combo
    type: combo
    presentation:
      dual_axis: true
      series_types:
        Revenue: column
        Orders: line
    query:
      dimensions:
        purchase_month: orders.purchase_month
      measures:
        revenue: null
        order_count: null
      sort:
        - field: purchase_month
          direction: asc
      limit: 60

API reference

Kind: chart. Renderer: echarts. Supported result shapes: category_multi_measure.

Field	Type	Default	Allowed values	Description
`query.dimensions`	`field mapping`	—	—	Groups query results and supplies category, hierarchy, matrix, graph, or geographic labels.
`query.limit`	`integer`	`no limit`	`positive integer`	Caps the number of rows returned to the renderer.
`query.measures`	`measure mapping`	—	—	Selects the governed semantic measures consumed by the visual shape.
`query.sort`	`sort list`	—	—	Orders query results by a returned field or measure alias.
`presentation.dual_axis`	`boolean`	`false`	`true` `false`	Places the second combo series on a separate value axis.
`presentation.series_types`	`mapping`	`automatic`	`line` `bar` `column`	Maps combo series names or measure aliases to renderer types.

Accessibility. Use a descriptive title and unit, and do not rely on color alone to distinguish series or values.