Getting Started

Let’s get started with Chart.js!

Alternatively, see the example below or check samples.

Create a Chart

In this example, we create a bar chart for a single dataset and render it on an HTML page. Add this code snippet to your page:

  1. <div>
  2.   <canvas id="myChart"></canvas>
  3. </div>
  5. <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
  7. <script>
  8.   const ctx = document.getElementById('myChart');
  10.   new Chart(ctx, {
  11.     type: 'bar',
  12.     data: {
  13.       labels: ['Red', 'Blue', 'Yellow', 'Green', 'Purple', 'Orange'],
  14.       datasets: [{
  15.         label: '# of Votes',
  16.         data: [12, 19, 3, 5, 2, 3],
  17.         borderWidth: 1
  18.       }]
  19.     },
  20.     options: {
  21.       scales: {
  22.         y: {
  23.           beginAtZero: true
  24.         }
  25.       }
  26.     }
  27.   });
  28. </script>

You should get a chart like this:

demo

Let’s break this code down.

First, we need to have a canvas in our page. It’s recommended to give the chart its own container for responsiveness.

  1. <div>
  2.   <canvas id="myChart"></canvas>
  3. </div>

Now that we have a canvas, we can include Chart.js from a CDN.

  1. <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>

Finally, we can create a chart. We add a script that acquires the myChart canvas element and instantiates new Chart with desired configuration: bar chart type, labels, data points, and options.

  1. <script>
  2.   const ctx = document.getElementById('myChart');
  4.   new Chart(ctx, {
  5.     type: 'bar',
  6.     data: {
  7.       labels: ['Red', 'Blue', 'Yellow', 'Green', 'Purple', 'Orange'],
  8.       datasets: [{
  9.         label: '# of Votes',
  10.         data: [12, 19, 3, 5, 2, 3],
  11.         borderWidth: 1
  12.       }]
  13.     },
  14.     options: {
  15.       scales: {
  16.         y: {
  17.           beginAtZero: true
  18.         }
  19.       }
  20.     }
  21.   });
  22. </script>

You can see all the ways to use Chart.js in the step-by-step guide.