Generate a Chart Image from URL

This service is a replacement for the Google Image Charts API, which is scheduled to turn off on March 14, 2019.

---

How It Works

Chart images are defined by their URLs. Each URL contains a JSON/Javascript object that includes all the data and display options. These options follow the popular open-source graphing library Chart.js. Use the documentation to define your chart.

Once you've written your config, render it as an image with https://quickchart.io/chart?c=[[insert config here]]. Try the realtime editor below:

Customize Your Chart

Let's get creative. The example below uses custom background colors, title, legend, stacked bars, axis labels, and data labels:

You can use any static customization option available in Chart.js. The best place to learn the extent of customization options is through the documentation.

A couple things to remember when customizing your chart:

• We recommend that you URL-encode the entire JSON config block. If not URL-encoded, you must escape all hex characters, e.g. #ff0000 → %23ff0000, or just use the rgb(255, 0, 0) equivalent
• Interactivity and animations are not supported (this service produces static images)

We also provide these additional options as query parameters:

• &width=500: Set the width of the image. Abbreviated as "w"
• &height=300: Set the height of the image. Abbreviated as "h"
• &backgroundColor=transparent: Set the background of the chart canvas. Abbreviated as "bkg"

Combine these parameters in your query string. For example: /chart?width=500&height=300&c={...}

POST endpoint

If your chart is large or complicated, you may prefer to send a POST request rather than a GET request. This avoids limitations on URL length and means you don't have to worry about URL encoding. The /chart POST endpoint takes the same parameters as above via the following JSON object:

        {
          "backgroundColor": "transparent",
          "width": 500,
          "height": 300,
          "chart": {...},
        }
      

Note that if you want to include Javascript options in chart, you'll have to send the parameter as a string rather than a JSON object.

---

Chart Types

Customization can be very simple. By changing type: bar to type: line, for example, we can instantly produce an equivalent line graph:

There are many other chart types as well:

You can combine charts together by specifying different "types":

Chart Annotations and Plugins

Three additional Chart.js plugins are supported: Data Labels (chartjs-plugin-datalabels), Annotations (chartjs-plugin-annotation), and Outlabels (chartjs-plugin-piechart-outlabels). These allow you to add various markup to your chart. Have a look at the documentation for each plugin to learn more about the possibilities.

QR codes

We also support QR code generation. You can render a QR code like so:

Remember the URL-encode your text parameter for more complex strings. The QR endpoint produces a PNG image by default. You may optionally set the query parameter format=svg for SVG format.

Specify the whitespace around QR image in modules with query parameter margin (defaults to 4), size in pixels of the square QR image (defaults to 150), and error correction level with ecLevel=M (valid values: L, M, Q, H).

If you'd like to customize the color of your QR code, use dark=000000 and light=ffffff. The parameters must be hex color codes. Here's the same code as above but with slimmer margins, more error protection, and colors:

About QuickChart.io

QuickChart is a free service built and maintained by Ian Webster. You may use images produced by this website for any purpose.

This service was built in response to the Google Image Charts shutdown and is supported by Arthena and Skeptical Investments.

QuickChart is a free public service that is shared between many users. It serves over 16 million charts per month. There is a 240 requests per minute per IP rate limit (4 charts/sec) on the public service. If you'd like to exceed this limit, please contact us to request an exception or discuss commercial pricing.

QuickChart is open source, dual licensed under the GNU GPLv3 and a commercial license. This means that QuickChart is never going away; anyone can host this service with minimal resource requirements. If you would like to modify QuickChart source code for commercial use, please contact us for a license.