Documentation

Legacy parameter reference

Every parameter below is implemented in the current release unless the table says otherwise. This page is the public summary of our compatibility contract; the project repository carries the full decision record (docs/legacy-params.md) and the 41-URL regression report.

Graceful degradation policy

  1. Unknown parameters are ignored and listed in the compatibility report.
  2. Invalid values fall back to a default and are reported as degraded.
  3. A decodable payload always produces a PNG — even if that means an approximate chart.
  4. 400 JSON is returned only when the data payload cannot be interpreted at all (missing chd, unknown encoding letter, no numeric value).
  5. A 200 response never carries an error image or error text.

Chart types (cht)

chtRendered asNotes
bvg, bv, bvertical grouped barsdefault when cht is missing
bhg, bh, bhshorizontal grouped bars
bvsvertical stacked bars
bvohorizontal stacked barsinterpretation choice, documented
lc, lline
lxyline with x/y pairseach series is read as x0,y0,x1,y1,…
lssparklineaxes and legend hidden
p, p3, pcpie (flat)p3 is not 3D
d, dn, donutdoughnut
r, rsradarrs uses line tension as an approximation
s, scscatterx/y pairs, no connecting line
qr, gv, tx, t, v, gom, f, fgapproximate bar chart or text cardQR, GraphViz, formula, map, Venn, meter, funnel — reported degraded

Data (chd, chds)

EncodingSyntaxBehaviour
Textchd=t:10,20,30|1,2,3real values, | separates series, -1 is a gap
Awesome aliaschd=a:30010,-30000.1Image-Charts format; treated as text (real magnitudes, automatic scaling)
Simplechd=s:AZaone character per value, alphabet A–Z a–z 0–9, _ is missing, scaled through chds
Extendedchd=e:AZaztwo characters per value, alphabet A–Z a–z 0–9 - ., _/__ missing

chds applies to s:/e: data. chds=a or absent autoscales (0–61 simple, 0–4095 extended); one min,max pair applies to all series, several pairs apply per series. A stray prefix digit (chd=t6:…) is tolerated.

Parameters

ParameterStatusNotes
chtsupportedchart type, see above
chssupporteddefault 300x200; sides clamped to 2000 px, area to 4,000,000 px² (reported when clamped)
chd, chdssupportedsee data encodings
chl, chdl, chdlpsupportedlabels, legend labels, legend position (b, t, l, r); _ becomes a space
chxt, chxl, chxrsupportedaxis declaration, per-axis labels, per-axis range/step
chxs, chxpsupportedaxis colour/size/alignment/tick marks; label positions
chcosupportedseries colours as RRGGBB or RRGGBBAA (hex without #); a few CSS names accepted
chtt, chtssupportedtitle and title style (colour, size, alignment)
chmasupportedmargins: left, right, top, bottom, plus legend margins
chgsupportedgrid steps and dash pattern; a step is used only when meaningful for the data span
chfsupportedsolid and multi-stop linear gradient fills for the image background and the plot area
chbh, chlssupportedbar width/gap (Chart.js percentages approximate pixel widths); per-series line width and dash
chmpartially supportedN data labels, o/c/d/s/x/t point markers, B area fills; annotation markers are accepted and ignored (degraded)
chofsupported when pngPNG is the only output; other values are reported unsupported
chxtcdegradedaccepted and ignored
chan, chld, chp, chty, chli, chtmunsupportedanimated GIF, map labels, pie rotation, map type, marker size, map region — reported, chart still renders

Multi-axis

Every declared chxt axis becomes a real scale. The first x is bottom, a second x is top, the first y is left, a second y is right, r is right and t is top:

https://urlchart.com/chart?cht=lc&chs=560x320
  &chd=t:120,180,150,210,260,300|800000,900000,850000,950000,880000,990000
  &chxt=x,y,y
  &chxr=1,0,350|2,0,1000000
  &chco=2f5fe0,dc3912
Line chart with a left axis for load and a right axis for large numbers, rendered by UrlChart.
Two value axes, formatted independently.

Series are assigned to the declared value axes in declaration order. When two or more value axes declare a range (chxr or numeric chxl), each series is matched to the axis whose range fits its data best; a series outside a declared range gets an autoscaled axis instead of a blank chart, and the difference is reported as degraded.

Numbers

Known gaps

Check the specific URL. The Drop-in Tester returns the supported/degraded/ignored list for any Google, Image-Charts or QuickChart URL — the same rules, before you migrate.