Skip to main content


NOTE: This component is only intended to support official API props via JSON. In particular, it is not intended to evolve an implementation of alternate JSON schemas. Support for such schemas should be developed independently, perhaps using the source code of this component as a base. See the JSON Layers RFC for more on this.

Converts a JSON description of a visualization into properties that can be passed to the Deck component.

Requirements on the JSON description:

  • Expected to contain at minimum "layers" and "initialViewState" fields.
  • The JSON for each layer should be formatted as in described in JSONLayer.


import {JSONConverter} from '';

import json from './us-map.json';

const configuration = {
layers: require('')

const new jsonConverter = new JSONConverter({configuration});

const deck = new Deck({
canvas: 'deck-canvas',



json (object | string)

A JSON string or a parsed JSON structure. All properties in this object, after processing, are passed to a Deck instance as props.


See more details in the Configuration Reference section.