Reference

Mark shortcuts

Vega-Lite mark shortcut directives that inject the mark field when absent from the spec body.

Mark shortcuts are sugar over ::vl that inject the mark field when it is absent from the spec body.

DirectiveVega-Lite mark
::chart-arc"arc"
::chart-area"area"
::chart-bar"bar"
::chart-boxplot"boxplot"
::chart-circle"circle"
::chart-errorband"errorband"
::chart-errorbar"errorbar"
::chart-geoshape"geoshape"
::chart-image"image"
::chart-line"line"
::chart-point"point"
::chart-rect"rect"
::chart-rule"rule"
::chart-square"square"
::chart-text"text"
::chart-tick"tick"
::chart-trail"trail"

Example — inline donut chart

::chart-arc{width="280" height="280"}
```
{
  "data": { "values": [{ "label": "Done", "n": 74 }, { "label": "Todo", "n": 26 }] },
  "encoding": {
    "theta": { "field": "n",     "type": "quantitative" },
    "color": { "field": "label", "type": "nominal" }
  }
}
```
::

All shortcuts accept the same attrs as ::vl — width, height, output, engine, and others. See Inline SVG directives.

Copyright © 2026