Vega-Lite chart reference

July 23, 2026 · View on GitHub

This page is generated from the live chart-template registry (scripts/gen-chart-reference.ts). Do not edit it by hand — run npm run gen:reference.

The Vega-Lite backend serves as Flint's reference implementation and offers the broadest chart coverage. Use it when you want the most complete support for declarative charts, including axis, scale, and faceting behavior.

What this page covers

This reference lists the 35 chart types currently supported by the Vega-Lite backend, grouped into 6 categories. Each chart entry shows:

Encoding channels — the visual roles accepted in chart_spec.encodings, such as x, y, color, size, column, or row.
Options — template-specific chart_spec.chartProperties keys, including control type, domain, default, availability, and description.

Use the chart type name exactly as shown in chart_spec.chartType.

How to set encodings and options

Set encodings in chart_spec.encodings and chart-specific options in chart_spec.chartProperties. Option keys match the parameter names below:

{
  "chartType": "Bar Chart",
  "encodings": { "x": { "field": "category" }, "y": { "field": "value" } },
  "chartProperties": { "cornerRadius": 4, "stackMode": "normalize" }
}

The Availability column shows whether a parameter is always available or conditional, meaning it appears only when the data and encodings make it relevant. For example, log-scale controls appear only on wide-range axes. Non-applicable parameters are safe to pass; the assembler ignores them.

Points

Scatter Plot

Encoding channels: x, y, color, size, shape, opacity, column, row

Parameter	Control	Domain	Default	Availability	Description
`opacity`	number	0.1 – 1 (step 0.1)	`1`	always	Mark opacity.
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.
`logScale_x`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the x-axis.
`logScale_y`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the y-axis.
`includeZero_x`	toggle	on / off	`false`	conditional	Anchor the x-axis at zero.
`includeZero_y`	toggle	on / off	`false`	conditional	Anchor the y-axis at zero.

Regression

Encoding channels: x, y, size, color, column, row

Parameter	Control	Domain	Default	Availability	Description
`regressionMethod`	choice	`linear` (Linear), `log` (Logarithmic), `exp` (Exponential), `pow` (Power), `quad` (Quadratic), `poly` (Polynomial)	`linear`	always	Regression fit method.
`polyOrder`	number	2 – 10 (step 1)	`3`	always	Polynomial order for the regression fit.
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.
`logScale_x`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the x-axis.
`logScale_y`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the y-axis.
`includeZero_x`	toggle	on / off	`false`	conditional	Anchor the x-axis at zero.
`includeZero_y`	toggle	on / off	`false`	conditional	Anchor the y-axis at zero.

Connected Scatter Plot

Encoding channels: x, y, order, color, detail, column, row

Parameter	Control	Domain	Default	Availability	Description
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.
`logScale_x`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the x-axis.
`logScale_y`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the y-axis.
`includeZero_x`	toggle	on / off	`false`	conditional	Anchor the x-axis at zero.
`includeZero_y`	toggle	on / off	`false`	conditional	Anchor the y-axis at zero.

Ranged Dot Plot

Encoding channels: x, y, color

Parameter	Control	Domain	Default	Availability	Description
`logScale_x`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the x-axis.
`logScale_y`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the y-axis.
`includeZero_x`	toggle	on / off	`false`	conditional	Anchor the x-axis at zero.
`includeZero_y`	toggle	on / off	`false`	conditional	Anchor the y-axis at zero.

Strip Plot

Encoding channels: x, y, color, size, column, row

Parameter	Control	Domain	Default	Availability	Description
`stepWidth`	number	10 – 100 (step 5)	`20`	always	Jitter spread width.
`pointSize`	number	0 – 150 (step 5)	`0`	always	Point or marker size.
`opacity`	number	0 – 1 (step 0.1)	`0`	always	Mark opacity.
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.
`logScale_x`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the x-axis.
`logScale_y`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the y-axis.
`includeZero_x`	toggle	on / off	`false`	conditional	Anchor the x-axis at zero.
`includeZero_y`	toggle	on / off	`false`	conditional	Anchor the y-axis at zero.

Bars

Bar Chart

Encoding channels: x, y, color, opacity, column, row

Parameter	Control	Domain	Default	Availability	Description
`cornerRadius`	number	0 – 15 (step 1)	`0`	always	Corner radius for supported marks.
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.
`xAxisType`	choice	`temporal` (Temporal), `nominal` (Discrete)	—	conditional	Interpret the x-axis as a continuous time scale or discrete bands.
`yAxisType`	choice	`temporal` (Temporal), `nominal` (Discrete)	—	conditional	Interpret the y-axis as a continuous time scale or discrete bands.

Grouped Bar Chart

Encoding channels: x, y, group, column, row

Parameter	Control	Domain	Default	Availability	Description
`dodge`	choice	`auto` (Auto), `local` (Local (compact)), `global` (Global (aligned))	`auto`	conditional	Dodge
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.

Stacked Bar Chart

Encoding channels: x, y, color, column, row

Parameter	Control	Domain	Default	Availability	Description
`stackMode`	choice	Stacked (default) (default), `normalize` (Normalize (100%)), `center` (Center)	—	conditional	Stacking strategy for overlapping series.
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.

Lollipop Chart

Encoding channels: x, y, color, column, row

Parameter	Control	Domain	Default	Availability	Description
`dotSize`	number	20 – 300 (step 10)	`80`	always	Size of the dot mark.
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.
`xAxisType`	choice	`temporal` (Temporal), `nominal` (Discrete)	—	conditional	Interpret the x-axis as a continuous time scale or discrete bands.
`yAxisType`	choice	`temporal` (Temporal), `nominal` (Discrete)	—	conditional	Interpret the y-axis as a continuous time scale or discrete bands.

Waterfall Chart

Encoding channels: x, y, color, column, row

Parameter	Control	Domain	Default	Availability	Description
`cornerRadius`	number	0 – 8 (step 1)	`0`	always	Corner radius for supported marks.
`totals`	choice	`auto` (Auto), `none` (None), `first` (First), `last` (Last), `both` (Both)	`auto`	conditional	Totals
`showTextLabels`	toggle	on / off	`false`	always	Render value labels on the marks.
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.

Gantt Chart

Encoding channels: y, x, x2, color, detail, column, row

Parameter	Control	Domain	Default	Availability	Description
`taskHeight`	number	40 – 90 (step 5)	`70`	always	Task bar height as a percentage of each row.
`cornerRadius`	number	0 – 8 (step 1)	`2`	always	Corner radius for supported marks.
`intervalLabels`	toggle	on / off	`false`	always	Text shown on task intervals.
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.
`logScale_x`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the x-axis.
`logScale_y`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the y-axis.
`includeZero_x`	toggle	on / off	`false`	conditional	Anchor the x-axis at zero.
`includeZero_y`	toggle	on / off	`false`	conditional	Anchor the y-axis at zero.

Bullet Chart

Encoding channels: y, x, goal, color, column, row

Parameter	Control	Domain	Default	Availability	Description
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.

Distributions

Histogram

Encoding channels: x, color, column, row

Parameter	Control	Domain	Default	Availability	Description
`binCount`	number	5 – 50 (step 1)	`Auto`	always	Maximum bin cap; Auto lets the backend choose.
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.

Density Plot

Encoding channels: x, color, column, row

Parameter	Control	Domain	Default	Availability	Description
`bandwidth`	number	0.05 – 2 (step 0.05)	`0`	always	Kernel-density bandwidth (0 = auto).
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.

ECDF Plot

Encoding channels: x, color, detail, column, row

Parameter	Control	Domain	Default	Availability	Description
`showPoints`	toggle	on / off	`false`	always	Overlay point markers on the line.
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.
`logScale_x`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the x-axis.
`logScale_y`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the y-axis.
`includeZero_x`	toggle	on / off	`false`	conditional	Anchor the x-axis at zero.
`includeZero_y`	toggle	on / off	`false`	conditional	Anchor the y-axis at zero.

Violin Plot

Encoding channels: x, y, color, row

Parameter	Control	Domain	Default	Availability	Description
`bandwidth`	number	0.05 – 2 (step 0.05)	`0`	always	Kernel-density bandwidth (0 = auto).
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.

Boxplot

Encoding channels: x, y, color, opacity, column, row

Parameter	Control	Domain	Default	Availability	Description
`whiskerMethod`	choice	`iqr` (Tukey (1.5 × IQR)), `minmax` (Min–Max)	`iqr`	always	Whiskers
`showOutliers`	toggle	on / off	`true`	conditional	Outliers
`dodge`	choice	`auto` (Auto), `local` (Local (compact)), `global` (Global (aligned))	`auto`	conditional	Dodge
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.
`logScale_x`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the x-axis.
`logScale_y`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the y-axis.
`includeZero_x`	toggle	on / off	`false`	conditional	Anchor the x-axis at zero.
`includeZero_y`	toggle	on / off	`false`	conditional	Anchor the y-axis at zero.

Pyramid Chart

Encoding channels: x, y, color

No template-specific parameters.

Candlestick Chart

Encoding channels: x, open, high, low, close, column, row

Parameter	Control	Domain	Default	Availability	Description
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.
`logScale_x`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the x-axis.
`logScale_y`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the y-axis.
`includeZero_x`	toggle	on / off	`false`	conditional	Anchor the x-axis at zero.
`includeZero_y`	toggle	on / off	`false`	conditional	Anchor the y-axis at zero.

Lines & Areas

Line Chart

Encoding channels: x, y, color, strokeDash, detail, opacity, column, row

Parameter	Control	Domain	Default	Availability	Description
`interpolate`	choice	Default (linear) (default), `linear` (Linear), `monotone` (Monotone (smooth)), `step` (Step), `step-before` (Step Before), `step-after` (Step After), `basis` (Basis (smooth)), `cardinal` (Cardinal), `catmull-rom` (Catmull-Rom)	—	always	Line or area interpolation method.
`showPoints`	toggle	on / off	`false`	always	Overlay point markers on the line.
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.
`logScale_x`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the x-axis.
`logScale_y`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the y-axis.
`includeZero_x`	toggle	on / off	`false`	conditional	Anchor the x-axis at zero.
`includeZero_y`	toggle	on / off	`false`	conditional	Anchor the y-axis at zero.
`xAxisType`	choice	`temporal` (Temporal), `nominal` (Discrete)	—	conditional	Interpret the x-axis as a continuous time scale or discrete bands.
`yAxisType`	choice	`temporal` (Temporal), `nominal` (Discrete)	—	conditional	Interpret the y-axis as a continuous time scale or discrete bands.

Sparkline

Encoding channels: x, y, color, detail, row, column

Parameter	Control	Domain	Default	Availability	Description
`interpolate`	choice	Default (linear) (default), `linear` (Linear), `monotone` (Monotone (smooth)), `step` (Step), `step-before` (Step Before), `step-after` (Step After), `basis` (Basis (smooth)), `cardinal` (Cardinal), `catmull-rom` (Catmull-Rom)	—	always	Line or area interpolation method.
`baseline`	choice	`mean` (Average), `zero` (Zero), `median` (Median), `none` (None)	`mean`	always	Reference line
`trendWidth`	number	80 – 600 (step 10)	`240`	always	Sparkline width
`logScale_x`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the x-axis.
`logScale_y`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the y-axis.
`includeZero_x`	toggle	on / off	`false`	conditional	Anchor the x-axis at zero.
`includeZero_y`	toggle	on / off	`false`	conditional	Anchor the y-axis at zero.

Bump Chart

Encoding channels: x, y, color, detail, column, row

Parameter	Control	Domain	Default	Availability	Description
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.
`logScale_x`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the x-axis.
`logScale_y`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the y-axis.
`includeZero_x`	toggle	on / off	`false`	conditional	Anchor the x-axis at zero.
`includeZero_y`	toggle	on / off	`false`	conditional	Anchor the y-axis at zero.

Slope Chart

Encoding channels: x, y, color, detail, column, row

Parameter	Control	Domain	Default	Availability	Description
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.
`logScale_x`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the x-axis.
`logScale_y`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the y-axis.
`includeZero_x`	toggle	on / off	`false`	conditional	Anchor the x-axis at zero.
`includeZero_y`	toggle	on / off	`false`	conditional	Anchor the y-axis at zero.

Area Chart

Encoding channels: x, y, color, opacity, column, row

Parameter	Control	Domain	Default	Availability	Description
`interpolate`	choice	Default (linear) (default), `linear` (Linear), `monotone` (Monotone (smooth)), `step` (Step), `step-before` (Step Before), `step-after` (Step After), `basis` (Basis (smooth)), `cardinal` (Cardinal), `catmull-rom` (Catmull-Rom)	—	always	Line or area interpolation method.
`opacity`	number	0.1 – 1 (step 0.1)	`0.7`	conditional	Mark opacity.
`stackMode`	choice	Stacked (default) (default), `normalize` (Normalize (100%)), `center` (Center), `layered` (Layered (overlap))	—	conditional	Stacking strategy for overlapping series.
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.
`xAxisType`	choice	`temporal` (Temporal), `nominal` (Discrete)	—	conditional	Interpret the x-axis as a continuous time scale or discrete bands.
`yAxisType`	choice	`temporal` (Temporal), `nominal` (Discrete)	—	conditional	Interpret the y-axis as a continuous time scale or discrete bands.

Streamgraph

Encoding channels: x, y, color, column, row

Parameter	Control	Domain	Default	Availability	Description
`interpolate`	choice	Default (linear) (default), `linear` (Linear), `monotone` (Monotone (smooth)), `step` (Step), `step-before` (Step Before), `step-after` (Step After), `basis` (Basis (smooth)), `cardinal` (Cardinal), `catmull-rom` (Catmull-Rom)	—	always	Line or area interpolation method.
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.

Range Area Chart

Encoding channels: x, y, y2, color, column, row

Parameter	Control	Domain	Default	Availability	Description
`interpolate`	choice	Default (linear) (default), `linear` (Linear), `monotone` (Monotone (smooth)), `step` (Step), `step-before` (Step Before), `step-after` (Step After), `basis` (Basis (smooth))	—	always	Line or area interpolation method.
`opacity`	number	0.1 – 1 (step 0.1)	`0.5`	always	Mark opacity.
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.

Circular

Pie Chart

Encoding channels: size, color, column, row

Parameter	Control	Domain	Default	Availability	Description
`innerRadius`	number	0 – 100 (step 5)	`0`	always	Inner radius as a percentage of the outer radius.
`sortSlices`	choice	`none` (Data order), `descending` (Largest first), `ascending` (Smallest first)	`none`	always	Sort slices
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.

Donut Chart

Encoding channels: size, color, column, row

Parameter	Control	Domain	Default	Availability	Description
`innerRadius`	number	0 – 100 (step 5)	`0`	always	Inner radius as a percentage of the outer radius.
`sortSlices`	choice	`none` (Data order), `descending` (Largest first), `ascending` (Smallest first)	`none`	always	Sort slices
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.

Rose Chart

Encoding channels: x, y, color, column, row

Parameter	Control	Domain	Default	Availability	Description
`padAngle`	number	0 – 0.1 (step 0.005)	`0`	always	Angular gap between radial segments.
`alignment`	choice	`left` (Left (default)), `center` (Center)	—	always	Segment alignment for radial charts.
`sortSlices`	choice	`none` (Data order), `descending` (Largest first), `ascending` (Smallest first)	`none`	always	Sort slices
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.

Radar Chart

Encoding channels: x, y, color, column, row

Parameter	Control	Domain	Default	Availability	Description
`filled`	toggle	on / off	`true`	always	Fill the enclosed radar area.
`fillOpacity`	number	0 – 0.5 (step 0.1)	`0.15`	always	Fill opacity for the area or region.
`strokeWidth`	number	0.5 – 4 (step 0.5)	`1.5`	always	Line stroke width.
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.
`logScale_x`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the x-axis.
`logScale_y`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the y-axis.
`includeZero_x`	toggle	on / off	`false`	conditional	Anchor the x-axis at zero.
`includeZero_y`	toggle	on / off	`false`	conditional	Anchor the y-axis at zero.

Tables & Maps

Heatmap

Encoding channels: x, y, color, column, row

Parameter	Control	Domain	Default	Availability	Description
`showTextLabels`	toggle	on / off	`false`	always	Render value labels on the marks.
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.
`xAxisType`	choice	`temporal` (Temporal), `nominal` (Discrete)	—	conditional	Interpret the x-axis as a continuous time scale or discrete bands.
`yAxisType`	choice	`temporal` (Temporal), `nominal` (Discrete)	—	conditional	Interpret the y-axis as a continuous time scale or discrete bands.

Bar Table

Encoding channels: y, x, color, column, row

Parameter	Control	Domain	Default	Availability	Description
`maxRows`	number	5 – 100 (step 1)	`20`	always	Maximum number of table rows to display.
`showPercent`	toggle	on / off	`false`	conditional	Show each value as a percentage of the total.
`independentYAxis`	toggle	on / off	`false`	conditional	Use independent y-scales for facets.

KPI Card

Encoding channels: metric, value, goal

Parameter	Control	Domain	Default	Availability	Description
`layout`	choice	`horizontal` (Horizontal), `vertical` (Vertical), `grid` (Grid)	`grid`	always	Layout
`style`	toggle	on / off	`true`	always	Card style
`behindThreshold`	number	0 – 1 (step 0.05)	`0.5`	conditional	Behind threshold
`logScale_x`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the x-axis.
`logScale_y`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the y-axis.
`includeZero_x`	toggle	on / off	`false`	conditional	Anchor the x-axis at zero.
`includeZero_y`	toggle	on / off	`false`	conditional	Anchor the y-axis at zero.

Map

Encoding channels: longitude, latitude, color, size, opacity

Parameter	Control	Domain	Default	Availability	Description
`region`	choice	`auto` (Auto-detect), `us` (United States), `world` (World)	`auto`	always	Region
`projection`	choice	`default` (Default), `mercator` (Mercator), `equalEarth` (Equal Earth), `orthographic` (Orthographic (Globe)), `stereographic` (Stereographic), `conicEqualArea` (Conic Equal Area), `conicEquidistant` (Conic Equidistant), `azimuthalEquidistant` (Azimuthal Equidistant), `mollweide` (Mollweide)	`default`	conditional	Projection
`projectionCenter`	choice	Default (default), `0,0` (World (Atlantic) [0, 0]), `150,0` (World (Pacific) [150, 0]), `105,35` (China [105, 35]), `-98,39` (USA [-98, 39]), `10,50` (Europe [10, 50]), `138,36` (Japan [138, 36]), `78,22` (India [78, 22]), `-52,-14` (Brazil [-52, -14]), `134,-25` (Australia [134, -25]), `100,60` (Russia [100, 60]), `20,0` (Africa [20, 0]), `45,28` (Middle East [45, 28]), `115,5` (Southeast Asia [115, 5]), `-60,-15` (South America [-60, -15]), `-100,45` (North America [-100, 45]), `-2,54` (UK [-2, 54]), `10,51` (Germany [10, 51]), `2,47` (France [2, 47]), `128,36` (Korea [128, 36])	—	conditional	Center
`logScale_x`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the x-axis.
`logScale_y`	toggle	on / off	`false`	conditional	Use a log/symlog scale on the y-axis.
`includeZero_x`	toggle	on / off	`false`	conditional	Anchor the x-axis at zero.
`includeZero_y`	toggle	on / off	`false`	conditional	Anchor the y-axis at zero.

Choropleth

Encoding channels: id, color, detail

Parameter	Control	Domain	Default	Availability	Description
`region`	choice	`auto` (Auto-detect), `us` (United States), `world` (World)	`auto`	always	Region