Show Sidebar Hide Sidebar

Plotly JSON chart schema

Plotly JSON chart schema

Background

The Plotly JSON visualization schema is a complete declarative format for creating, saving, and sharing interactive, scientific charts. The advantage of saving charts as JSON is portability - charts can be shared across any language or platform that understands the schema.

The complete JSON schema is maintained as part of Plotly’s V2 REST API:

Translations of the JSON schema for practical use in several languages are also available:

Simple Example

Below is a Plotly bar chart with the JSON specification that describes it.

Chart Image

"Basic bar chart"

JSON Descripton of Chart
{
    "data": [
        {
            "x": [
                "giraffes", 
                "orangutans", 
                "monkeys"
            ], 
            "y": [
                20, 
                14, 
                23
            ], 
            "type": "bar"
        }
    ]
}

More Examples

Chart JSON description
Area Chart JSON
Pie Chart JSON
Line Chart JSON

Cross-Language Translation

Using this JSON specification, it is easy to handle translation between different chart and data formats:

JSON Editor

Try updating the chart by editing the JSON specification in this editor.

See the Pen Json Editor by Plotly (@plotly) on CodePen.

Still need help?
Contact Us

For guaranteed 24 hour response turnarounds, upgrade to our Premium or Enterprise plans.