Scatter chart

Use a scatter chart to compare category positions, expose series, or emphasize individual points.

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

Basic

Use an ordered category and numeric measure to place one point per period, making isolated delivery values and gaps easy to spot.

Key fields

visuals:
  delivery_scatter:
    title: Delivery days scatter by month
    type: scatter
    query:
      dimensions:
        purchase_month: orders.purchase_month
      measures:
        delivery_days: null
      sort:
        - field: purchase_month
          direction: asc
      limit: 30

Multiple series

Map status through query.series to split points into comparable groups while retaining the same axes.

Key fields

visuals:
  delivery_scatter_status:
    title: Delivery days scatter by status
    type: scatter
    query:
      dimensions:
        purchase_month: orders.purchase_month
      series:
        field: orders.status
        alias: status
      measures:
        delivery_days: null
      sort:
        - field: purchase_month
          direction: asc
      limit: 60

Labeled points

Enable labels and place them above larger symbols when exact point values matter and the dataset is small enough to avoid overlap.

Key fields

visuals:
  delivery_scatter_labeled:
    title: Labeled delivery scatter
    type: scatter
    presentation:
      show_labels: true
      label_position: top
      symbol_size: 12
    query:
      dimensions:
        delivery_bucket: orders.delivery_bucket
      measures:
        delivery_days: null
      sort:
        - field: delivery_bucket
          direction: asc

API reference

Kind: chart. Renderer: echarts. Supported result shapes: category_series_value 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.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.series`	`field reference`	—	—	Splits one measure into named series for compatible chart shapes.
`query.sort`	`sort list`	—	—	Orders query results by a returned field or measure alias.
`presentation.label_position`	`string`	`renderer default`	`top` `bottom` `left` `right` `inside` `outside`	Positions value labels relative to their marks.
`presentation.show_labels`	`boolean`	`false`	`true` `false`	Shows value labels directly on chart marks.
`presentation.symbol_size`	`number`	`9`	`positive number`	Sets point symbol size for line, area, and scatter series.

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