Funnel chart

Use a funnel chart to show ordered stages whose values usually decrease through a process.

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

Basic

Sort a categorical measure descending so the widest stage appears first and each following stage narrows with its value.

Key fields

visuals:
  status_funnel:
    title: Orders by status funnel
    type: funnel
    query:
      dimensions:
        status: orders.status
      measures:
        order_count: null
      sort:
        - field: value
          direction: desc

Alternate dimension

Replace status with delivery buckets to reuse the funnel for an ordered operational distribution rather than a lifecycle stage.

Key fields

visuals:
  delivery_funnel:
    title: Delivery speed funnel
    type: funnel
    query:
      dimensions:
        delivery_bucket: orders.delivery_bucket
      measures:
        order_count: null
      sort:
        - field: delivery_bucket
          direction: asc

Aligned labels

Set presentation.align: left to anchor the stages, keep labels visible, and use presentation.sort to control the visual stage order independently.

Key fields

visuals:
  status_funnel_left:
    title: Left aligned status funnel
    type: funnel
    presentation:
      align: left
      sort: ascending
      show_labels: true
    query:
      dimensions:
        status: orders.status
      measures:
        order_count: null
      sort:
        - field: value
          direction: asc

API reference

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

Field	Type	Default	Allowed values	Description
`query.dimensions`	`field mapping`	—	—	Groups query results and supplies category, hierarchy, matrix, graph, or geographic labels.
`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.align`	`string`	`center`	`left` `center` `right`	Aligns funnel stages within the plotting area.
`presentation.show_labels`	`boolean`	`true`	`true` `false`	Shows value labels directly on chart marks.
`presentation.sort`	`string`	`descending`	`ascending` `descending` `none`	Controls the renderer-side ordering of funnel stages.

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