Need help with vega?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

9.4K Stars 1.2K Forks BSD 3-Clause "New" or "Revised" License 6.2K Commits 362 Opened issues


A visualization grammar.

Services available


Need anything else?

Contributors list

Vega: A Visualization Grammar

Vega Examples

Vega is a visualization grammar, a declarative format for creating, saving, and sharing interactive visualization designs. With Vega you can describe data visualizations in a JSON format, and generate interactive views using either HTML5 Canvas or SVG.

For documentation, tutorials, and examples, see the Vega website. For a description of changes between Vega 2 and later versions, please refer to the Vega Porting Guide.

Build Instructions

For a basic setup allowing you to build Vega and run examples:

  • Clone
  • Run
    to install dependencies for all packages. If you don't have yarn installed, see We use Yarn workspaces to manage multiple packages within this monorepo.
  • Once installation is complete, run
    yarn test
    to run test cases, or run
    yarn build
    to build output files for all packages.
  • After running either
    yarn test
    yarn build
    , run
    yarn serve
    to launch a local web server — your default browser will open and you can browse to the
    folder to view test specifications.

This repository includes the Vega website and documentation in the

folder. To launch the website locally, first run
bundle install
in the
folder to install the necessary Jekyll libraries. Afterwards, use
yarn docs
to build the documentation and launch a local webserver. After launching, you can open
to see the website.

ES5 Support

For backwards compatibility, Vega includes a babel-ified ES5-compatible version of the code in

directory. Older browser would also require several polyfill libraries:

Contributions, Development, and Support

Interested in contributing to Vega? Please see our contribution and development guidelines, subject to our code of conduct.

Looking for support, or interested in sharing examples and tips? Post to the Vega discussion forum or join the Vega slack organization! We also have examples available as Observable notebooks.

If you're curious about system performance, see some in-browser benchmarks. Read about future plans in our roadmap.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.