Getting Started in JavaScript

Getting Started with plotly


Plotly is known for its graphing libraries, but it's also a broader ecosystem for building interactive data apps, AI data analysis tools, and deploying and hosting Dash apps. Explore the full set of tools and platforms designed to help turn data into action. Discover Plotly.

NPM

You can install Plotly.js from NPM via npm install plotly.js-dist or yarn add plotly.js-dist

plotly.js CDN

You can also use the ultrafast plotly.js CDN link. This CDN is graciously provided by the incredible team at Fastly.

<head>
               <script src="/?url=https%3A%2F%2Fcdn.plot.ly%2Fplotly-4.1.1.min.js" charset="utf-8"></script>
</head>
plotly-latest.js and plotly-latest.min.js are no longer the latest releases of Plotly.js. They are legacy bundles frozen at v1.58.5 (July 2021) and will not be updated. Use an explicit version number as shown above to get the most recent release.

Download

Download the minified plotly.js source code and dependencies.

Include the downloaded scripts before the end of the </head> tag in your HTML document:

<head>
	<script src="/?url=https%3A%2F%2Fplotly.com%2Fjavascript%2Fgetting-started%2Fplotly-4.1.1.min.js" charset="utf-8"></script>
</head>

Download plotly.js

Start plotting!

In your HTML document, create an empty DIV to draw the graph in:

<div id="tester" style="width:600px;height:250px;"></div>

Now you can make interactive plotly.js charts using Plotly.newPlot().

<script>
	TESTER = document.getElementById('tester');
	Plotly.newPlot( TESTER, [{
	x: [1, 2, 3, 4, 5],
	y: [1, 2, 4, 8, 16] }], {
	margin: { t: 0 } } );
</script>

Now you can pass Plotly.newPlot() either the ID of the DIV ("tester") or the DIV DOM element (TESTER).

Hello World Example