Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Vega Viewer

Version Installs Downloads

Vega Viewer provides language support and Interactive Preview of Vega and Vega-Lite JSON specification graphs. Use Vega Viewer to find and prototype custom data visualizations using Vega maps πŸ—ΊοΈ and graphs πŸ“ˆ.

Advanced Vega Charts


  • Create Vega or Vega-Lite JSON {} specification documents
  • Vega and Vega-Lite Graphs Preview πŸ“ˆ
  • Local and http(s) data files support
  • SVG and PNG Graph Export options
  • 724 searchable built-in Vega and Vega-Lite Examples
  • Vega Themes Preview
  • Load Vega specs from online Vega Editor or github gists
  • Preview Vega graphs πŸ“ˆ from starred gists, playgrounds, and data visualizations in GistPad πŸ“˜
  • View and Share Vega(-Lite) spec in the online Vega Editor
  • Referenced CSV and JSON data display via Data Preview 🈸

Vega Viewer Data Preview


Install Vega Viewer πŸ“ˆ from VSCode Extensions tab (Ctrl+Shift+X) by searching for Vega, or directly from Visual Studio Marketplace link in your browser.

Users of VSCodium, Azure Data Studio, and other VSCode-based IDEs can install Vega Viewer using .vsix extension package attached in Assets section from published releases of this extension on github. Follow install from .vsix instructions in your VSCode extensions compatible IDE or online container service to install it.

Note: VSCodium and other VSCode extension compatible IDE flavors are not officially supported as they require additional testing in those IDE variants.


Install Data Preview 🈸 or use built-in command to preivew CSV and JSON data files referenced in your Vega graph πŸ“ˆ specifications.

Vega Viewer Data Preview Command Setting


  1. Use Vega: Create Vega Spec command from View -> Command Pallette... menu to Create and Save new Vega or Vega-Lite document with the corresponding Vega json $schema reference.

  2. Use Vega: Preview Vega Graph command on an open .vg.json or .vl.json Vega spec document to Preview Graph πŸ“ˆ.

  3. Save updated Vega spec json document to Preview updated Graph πŸ“ˆ.

  4. Use Vega: Preview Remote Vega Graph command to preview URL encoded Vega specs from online Vega Editor or github gists.

Built-in Examples

  1. Use Vega: Examples command to view the list of built-in Vega Examples.

  2. Use Vega: Lite Examples command to view all the Vega-Lite Maps πŸ—Ί and Graphs πŸ“ˆ created by the Vega dev community.

  3. Use Vega: Visual Vocabulary Examples command to View quick list of Visual Vocabulary Vega Examples.


Example: Vega Contour Plot Preview

Vega Viewer Plot Example

Vega Viewer VSCode Contributions

Vega Viewer Settings, Commands, Keyboard Shortcuts, Languages, and JSON Validation feature contributions:

Vega Viewer Contributions

Vega Viewer Commands

Vega Viewer provides the following Commands to view built-in Vega and Vega-Lite graph examples and create new visualization specification documents:

Vega Viewer Commands

Vega Viewer GistPad Integration

Vega Viewer integrates with GistPad extension for Vega and Vega-Lite graph Previews:

Vega Viewer Gistpad Integration

Recommended Extensions

Recommended extesnsions for working with data, gists, maps and SVG graphs πŸ“ˆ in VSCode:

Extension Description
Data Preivew 🈸 Data Preview 🈸 extension for importing πŸ“€ viewing πŸ”Ž slicing πŸ”ͺ dicing 🎲 charting πŸ“Š & exporting πŸ“₯ large JSON array/config, YAML, Apache Arrow, Avro & Excel data files.
GistPad πŸ“˜ VS Code extension for managing and sharing code snippets, notes and interactive samples using GitHub Gists.
SVG SVG language support extension.
Geo Data Viewer πŸ—ΊοΈ Geo Data Viewer for generating snazzy maps πŸ—ΊοΈ with keplerGL.

Dev Log

See #VegaViewer πŸ“ˆ tag on Twitter for the latest updates on this vscode extension development.

Dev Build

$ git clone
$ cd vscode-vega-viewer
$ npm install
$ code .

F5 to launch Vega Viewer extension VSCode debug session:

Alt text


Any and all test, code and feedback contributions are welcome.

Open an issue or create a pull request to make Vega Viewer πŸ“ˆ work better for all.


Become a Fan and sponsor our dev efforts on this and other Random Fractals, Inc. code and data viz extensions if you find them useful, educational, or enhancing your daily dataViz/dev code workflows:

β˜•οΈ πŸ’–