Use it in

Charts in email reports.

Email clients show images from a URL, so a chart URL in your HTML shows for every recipient. The first open renders the chart; every other open comes from cache.

Revenue, week 39To: team@yourcompany.com

Morning. Revenue for last week is below. Saturday was the best day.

Bar chart: revenue this week, highest on Saturday at $7,400

Set it up.

  1. Write the URL

    Start from the weekly revenue example and put your own numbers in y.

  2. Fill it in and sign it

    Your report job joins this week's numbers with commas, drops them into the URL and signs it with your secret key. The signing docs have the code.

  3. Paste it into the template

    As an img tag with width 600 and alt text that says what the chart shows.

<img src="https://c.renderchart.com/?key=rc_pub_live_7Hq2mX9pLk4vN8sT1wEa&type=bar&x=Mon,Tue,Wed,Thu,Fri,Sat,Sun&y=4200,3900,5100,4800,6200,7400,5300&title=Revenue%20this%20week%20%28%24%29&values=1&h=400"
     width="600" height="400" alt="Weekly revenue">

Which kind of URL.

Signed, if your code sends the email

  • A report job can sign each URL as it writes the email: no watermark on a paid plan, nobody can change the numbers, and past your allowance the chart carries on as an extra render.
  • An email tool that fills the numbers in with merge tags can't sign. Its charts are unsigned: they carry the watermark on every plan, and the key has to accept unsigned URLs.
  • Sign on your server, never in the email or the browser. The secret key stays with you.

Unsigned, signed and short URLs compared

Worth knowing.

Size
w=600, the usual width of an email body. The default dpr=2 keeps it sharp on phones.
Link tracking
Unknown parameters are ignored, so utm_source and the like added by your email tool never break a chart or cause a new render.
Alt text
Some clients hold images until the reader allows them. Say what the chart shows: "Revenue this week, highest on Saturday at $7,400".
Cost
One render when the numbers change, however many people open the email.