The open source JavaScript graphing library that powers Plotly

Show Sidebar Hide Sidebar

React Plotly.js in plotly.js

How to use the Plotly.js React component.

Use react-plotly.js to embed D3 charts in your React-powered web application. This React component takes the chart type, data, and styling as Plotly JSON in its data and layout props, then draws the chart using Plotly.js. See below about how to get started with react-plotly.js.

$ npm install react-plotly.js plotly.js

The easiest way to use this component is to import and pass data to a plot component:

import React from 'react';
import Plot from 'react-plotly.js';

class App extends React.Component {
  render() {
    return (
            x: [1, 2, 3],
            y: [2, 6, 3],
            type: 'scatter',
            mode: 'lines+points',
            marker: {color: 'red'},
          {type: 'bar', x: [1, 2, 3], y: [2, 5, 3]},
        layout={ {width: 320, height: 240, title: 'A Fancy Plot'} }

For information on more advanced usage patterns such as State Management or Customizing the plotly.js bundle please see the ReadMe for react-plotly.js.

More information about Props and Event Handlers can be found in the ReadMe for react-plotly.js.

Click here for more information about Plotly Chart Types and Attributes.

Still need help?
Contact Us

For guaranteed 24 hour response turnarounds, upgrade to a Developer Support Plan.