Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

vega-lite

vega702kBSD-3-Clause6.1.0TypeScript support: included

Vega-Lite is a concise high-level language for interactive visualization.

vega, chart, visualization

readme

Vega-Lite

npm version Build Status codecov code style: prettier JSDevlivr

Teaser

Vega-Lite provides a higher-level grammar for visual analysis that generates complete Vega specifications.

You can find more details, documentation, examples, usage instructions, and tutorials on the Vega-Lite website.

Try using Vega-Lite in the online Vega Editor.

Contributions are also welcome. Please see CONTRIBUTING.md for contribution and development guidelines and our Code of Conduct.

Read about future plans in our roadmap.

Team

The development of Vega-Lite is led by the alumni and members of the University of Washington Interactive Data Lab (UW IDL), including Kanit "Ham" Wongsuphasawat (now at Databricks), Dominik Moritz (now at CMU and Apple), Arvind Satyanarayan (now at MIT), and Jeffrey Heer (UW IDL).

Vega-Lite gets significant contributions from its community. Please see the contributors page for the full list of contributors.

Citing Vega-Lite

@article{2017-vega-lite,
  doi = {10.1109/tvcg.2016.2599030},
  year = {2017},
  author = {Arvind Satyanarayan and Dominik Moritz and Kanit Wongsuphasawat and Jeffrey Heer},
  title = {Vega-Lite: A Grammar of Interactive Graphics},
  journal = {{IEEE} Transactions on Visualization \& Computer Graphics (Proc. InfoVis)},
  url = {http://idl.cs.washington.edu/papers/vega-lite},
}

changelog

Changelog

6.0.2 (2025-03-28)

Bug Fixes

6.0.1 (2025-03-28)

Bug Fixes

  • correct peer dependency (984ea50)

6.0.0 (2025-03-28)

Bug Fixes

  • correct build normalized example script (#9571) (4cbf2fd)
  • correct y axis title in boxplot when mark.extent isnt set (#9483) (f3dc811)
  • correctly support timeFormatSpecifier in Vega-Lite (#9455) (9325b67)
  • prefer user-defined tickMinStep to defaultTickMinStep (#9461) (31a76e7)
  • remove extra backtick in LegendConfig.labelOverlap documentation (#9560) (44fe4ac)

5.23.0 (2024-12-10)

Bug Fixes

Features

  • frame animations with time encoding and timer param (#8921) (e3f9620)

5.21.0 (2024-08-28)

Bug Fixes

Features

  • update code to not need implicit any, add hasProperty util (#9394) (6ce344e)

5.20.1 (2024-07-31)

Bug Fixes

  • #9401: conditional opacity should respect default value (#9402) (b4c7e14), closes #9401

5.20.0 (2024-07-30)

Bug Fixes

  • for issue when there are multiple aggregates with the same data field and aggregation operation (#9320) (da84469), closes #6184
  • make tick size responsive to plot height (#9395) (3f5dce6)

Features

5.19.0 (2024-06-14)

Bug Fixes

Features

  • more options and examples for how marks and scales represent invalid data (e.g., nulls, NaNs) (#9342) (502db1d), closes #8254

5.18.1 (2024-05-07)

Bug Fixes

5.18.0 (2024-04-09)

Bug Fixes

Features

  • add explicit option to control how densities are resolved, change how densities are resolved by default (#9172) (bf0b8d3)

5.17.0 (2024-03-12)

Bug Fixes

Features

5.16.3 (2023-11-10)

Bug Fixes

5.16.2 (2023-11-08)

Bug Fixes

5.16.1 (2023-10-12)

Bug Fixes

5.16.0 (2023-10-09)

Bug Fixes

Features

  • make bar & rect marks support bandPosition (allow center-alignment with ticks) (#9126) (bd014eb)
  • swap 'mouse' events to 'pointer' events for mobile compatibility; update site and docs (#9089) (fa97659)

5.15.1 (2023-10-02)

Bug Fixes

  • correct the formula for interpolating between bin start and end (interpolatedSignalRef) (#9111) (d4b27bb)
  • use resolve "shared" instead of steps to fix artifacts in grouped density transform (#9106) (06e63e6)

5.15.0 (2023-09-13)

Bug Fixes

  • unescape paths in binned timeUnits to allow for fields with periods in name (#9088) (53ede0e)
  • update ts and fix typing issues (#9066) (b421a44)

Features

  • switch from clone to built in structured clone (#9068) (7874ea9)

5.14.1 (2023-07-20)

Bug Fixes

  • Area with plain quantitative fields on both axes get stacked by default (#9018) (b79bc9f)

5.14.0 (2023-07-20)

Bug Fixes

Features

5.13.0 (2023-07-07)

Features

  • support domainRaw so one may bind domainRaw to a parameter to build custom interaction (#8989) (21c823d)

5.12.0 (2023-06-29)

Features

5.11.1 (2023-06-26)

Bug Fixes

  • show gridline of first axis only for dual axes charts (#8962) (a522a87)

5.11.0 (2023-06-21)

Bug Fixes

  • make bin/timeUnit band respect minBandSize config (#8958) (d1c012e)

Features

5.10.0 (2023-06-20)

Bug Fixes

Features

5.9.3 (2023-05-18)

Bug Fixes

5.9.2 (2023-05-17)

Bug Fixes

  • make durationExpr work for week (#8907) (bf99571)
  • respect bandWithNestedOffsetPaddingInner for grouped bar within discretized temporal axis (#8906) (9050e6b)

5.9.1 (2023-05-15)

Bug Fixes

5.9.0 (2023-05-05)

Features

  • allow custom tooltip formatting (#8883) (e7b45b8)
  • support grouped bars inside time axis with time bins (#8874) (b29fa64)

5.8.0 (2023-05-01)

Bug Fixes

  • avoid repetitive labels by using tickMinStep (#8872) (0b1c385)
  • remove incorrect stack transform from charts with one linear Q-axis one non-linear Q-axis. (#8871) (f4d928a)

Features

5.7.1 (2023-04-17)

5.7.0 (2023-04-15)

Bug Fixes

  • add repeat prefix to name in normalization (#8733) (2ea3265)
  • allow setting width/height in repeated layers (#8723) (9e26410)
  • correctly apply stacked to bar with quantitative x and quantitative y axes (#8838) (4b9d22c)
  • correctly handle merging of domains with more than one sort object (#8567) (1eedb8f)
  • move name from layer chart to one of the inside layers (#8662) (d99f614)
  • orient logic for when bar with x=T + simplify logic (#8739) (ea4aa64)
  • prevent duplicate spec names in top-level selection view paths (#8486) (ba46bd2)

Features

  • enable interval selections for cartographic projections (#6953) (e5cbe8f)

5.6.1 (2023-02-13)

  • chore: require clean working dir and main for releases (b9f15eb)
  • chore: switch to release-it (4a02b5a)
  • chore: update lockfile (bddc5d5)
  • chore: upgrade deps including rollup (e757bfd)
  • chore(deps-dev): bump @auto-it/conventional-commits from 10.38.5 to 10.42.0 (#8704) (4797d48), closes #8704
  • chore(deps-dev): bump @auto-it/first-time-contributor from 10.38.5 to 10.42.0 (#8710) (4912870), closes #8710
  • chore(deps-dev): bump @typescript-eslint/eslint-plugin from 5.50.0 to 5.51.0 (#8705) (0cbfb2b), closes #8705
  • chore(deps-dev): bump @typescript-eslint/parser from 5.50.0 to 5.51.0 (#8706) (3b8e8d8), closes #8706
  • chore(deps-dev): bump auto from 10.38.5 to 10.42.0 (#8711) (ebe2fbf), closes #8711
  • chore(deps-dev): bump eslint from 8.33.0 to 8.34.0 (#8709) (0ab6c0e), closes #8709
  • chore(deps-dev): bump prettier from 2.8.3 to 2.8.4 (#8703) (534cec1), closes #8703
  • chore(deps-dev): bump vega-datasets from 2.5.3 to 2.5.4 (#8707) (c64cf94), closes #8707
  • chore(deps-dev): bump vega-embed from 6.21.0 to 6.21.2 (#8712) (59c0650), closes #8712

5.6.0 (2022-10-14)

  • Bump version to: 5.6.0 [skip ci] (1ff500a)
  • Update CHANGELOG.md [skip ci] (71a7e87)

5.5.0 (2022-08-15)

  • Bump version to: 5.5.0 [skip ci] (0a2b57f)
  • Update CHANGELOG.md [skip ci] (6562bea)

v5.6.0 (Fri Oct 14 2022)

:tada: This release contains work from new contributors! :tada:

Thanks for all your work!

:heart: Lam Thien Toan (@danielmalaton)

:heart: Brandon Hamilton (@mistidoi)

:heart: null@sl-solution

:heart: Zachary Bys (@ZacharyBys)

🚀 Enhancement

🐛 Bug Fix

Authors: 12


v5.5.0 (Mon Aug 15 2022)

:tada: This release contains work from new contributors! :tada:

Thanks for all your work!

:heart: fish (@fish-404)

:heart: Jon Mease (@jonmmease)

:heart: Dan Marshall (@danmarshall)

🚀 Enhancement

🐛 Bug Fix

Authors: 8