How to send Chart.js in emails

Chart.js is a best-in-class library that does a great job rendering charts for the browser. But emails can’t contain Javascript, only static HTML.

If you want to send emails that contain Chart.js charts, you’ll have to render them as images.

Because Chart.js is a Javascript library, the image requirement means you’ll have to jump through a few hoops:

  1. Render the charts on a backend capable of executing Javascript
  2. Upload the rendered chart image somewhere
  3. Send an email containing the image

You too can render Chart.js in emails.

Option 1: Render the chart with a headless browser

Libraries like Puppeteer solve the rendering problem by using the Chrome web browser to render a webpage that includes a chart.

In order to do this in Puppeteer, set up a page with your Chart.js bundle and take a screenshot of the canvas element.

async screenshotChart(chartConfig) {
// Set up the browser and the page.
const browser = await puppeteer.launch();
const page = await browser.newPage();

await page.setContent(
`<!DOCTYPE html>
<canvas id="chart-canvas" width="
${width}" height="${height}"></canvas>


await page.addScriptTag({
path: '/path/to/Chart.bundle.min.js')

const canvas = await page.$('#chart-canvas');

// Render the chart.
await page.evaluate((canvas, config) => {
const ctx = canvas.getContext('2d');
const chart = new Chart(ctx, config);
}, canvas, chartConfig);

// Take a screenshot.
const image = await canvas.screenshot({
omitBackground: true

return image;

This is a fine solution for small-scale rendering. There are two problems:

  1. Puppeteer is resource-intensive. You’ll need a machine with enough RAM to run a headless web browser and all its dependencies. In general, it takes a lot of work to set up a robust render farm that can stay online and process lots of charts efficiently.
  2. You may run into issues with sizing, blurriness, and viewport resolution.
  3. Depending on performance requirements, you may to store the generated images and expire them as necessary.

Usually it’s easier to go with a dedicated render API that saves you the trouble of having to set up and maintain rendering infrastructure yourself. Which brings us to…

Option 2: Render the chart with a chart image API

QuickChart is an open-source API that renders Chart.js charts as images. Send it a request with your Chart.js config and it will return your rendered chart. This does not require any dependencies other than making an HTTP request.

The main QuickChart endpoint is Use this as a base URL, then provide some query parameters:

  • chart or c: The Chart.js object (required)
  • width: Width of chart in pixels (optional)
  • height: Height of chart in pixels (optional)
  • devicePixelRatio: Ratio between physical pixels and logical pixels. Defaults to 2.0 for retina support (optional)
  • View more parameters in the documentation

Take this Chart.js config for example:

type: 'bar',
data: {
labels: [2012, 2013, 2014, 2015, 2016],
datasets: [{
label: 'Users',
data: [120, 60, 50, 180, 120]

Place the config into the URL:{type:'bar',data:{labels:[2012,2013,2014,2015,2016],datasets:[{label:'Users',data:[120,60,50,180,120]}]}}

Now, place this URL in an image tag within an HTML email body:

<img src="{type:'bar',data:{labels:[2012,2013,2014,2015,2016],datasets:[{label:'Users',data:[120,60,50,180,120]}]}}" />

And you’ll get a chart image:

You can safely embed this chart directly in your email. It doesn’t require any Javascript, and anyone with an email client that can show images will be able to see your chart.

For more advanced usage and many other chart types and customization, view the documentation.

Ian Webster

About the author

Ian Webster is a software engineer and former Googler based in San Mateo, California. He has helped Google, NASA, and governments around the world improve their data pipelines and visualizations. In 2018, Ian created QuickChart, a collection of open-source APIs that support data visualization efforts.

Email · LinkedIn · Twitter