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, bhhorizontal grouped bars
bvs, bhsvertical / horizontal stacked barsbhs stacks along the horizontal axis
bvohorizontal stacked barsinterpretation choice, documented
lc, lline
lxyline through x/y pairsseries 0 holds the x values and every further series is a y set — one line per set, the same rule as cht=s
lssparklineaxes and legend hidden
p, p3, pcpie (flat)p3 is not 3D
d, dn, donut, pddoughnutpd is the Image-Charts name; chli sets the centre label
papolar areaImage-Charts name; one sector per value, chl labels them
r, rsradarrs uses line tension as an approximation
s, scscatterseries 1 is x, each further series is a y point set; points only, no connecting line
bbbubbleImage-Charts name: series 0 = x, series 1 = y, series 2 = radius (radius 5 when absent)
qrreal QR code (decodable)chl payload, chld error-correction level/margin, choe encoding; always square — not an approximation
gv, tx, t, v, gom, f, fgapproximate bar chart or text cardGraphViz, 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 rescales s:/e: data: one min,max pair applies to all series, several pairs apply per series, chds=a autoscales from the decoded values and an absent chds keeps Google's full alphabet range (0–61 simple, 0–4095 extended). Text values (chd=t:) are never rescaled — they already carry their magnitudes — but a declared chds span still sets the value-axis range (an explicit chxr wins and the override is reported). A stray prefix digit (chd=t6:…) is tolerated.

A missing value (-1, an empty field, _/__) is a gap: bars leave the slot empty, a line breaks there (an isolated point between two gaps is drawn as a dot so the chart never reads as blank), and a pie leaves that sector out. The gaps are counted in X-UrlChart-Meta.

For scatter (cht=s) the first series is x and each further series is a y point set sharing those x values: chd=t:10,20,30|1,2,3|4,5,6 plots two point sets. A single-series scatter is read as flat x,y pairs and reported degraded. chxr, chg and numeric chxl ticks work on the two numeric axes just as they do on a line chart, and chm point markers set shape, colour and size.

QR codes (cht=qr) — fully supported

cht=qr is not one of the approximate types: it produces a real, standards-compliant QR code that a phone camera decodes (chart kind qr, byte mode, deterministic module grid). It belongs to no approximate group anywhere on this page; GraphViz, formulas, maps, Venn diagrams, funnels and meters are the approximate families.

A QR chart reads chl as the payload (URL-decoded, underscores literal) instead of chd; chd, axes and legends are not used. chld=<L|M|Q|H>|<margin> sets the error-correction level (default L) and quiet-zone margin in modules (default 4, capped at 16). choe accepts UTF-8 (default), Shift_JIS and ISO-8859-1; payload bytes are always written as UTF-8, so choe=UTF-8 is exact and the other two are accepted with a degraded note (they never produce a garbled code). chs sets the canvas: the square code is centred, and a non-square size is reported degraded.

A byte-mode QR holds at most 2953 bytes (version 40, level L). If the payload does not fit the requested level, the same bytes are re-encoded at L (reported degraded). If even L cannot hold it, a text card explains the limit — the payload is never truncated, because a QR that encodes different data is worse than no QR.

https://urlchart.com/chart?cht=qr&chs=200x200
  &chl=https%3A%2F%2Fexample.com%2Fp%2F42
  &chld=H|4&choe=UTF-8

Parameters

ParameterStatusNotes
chtsupportedchart type, see above
chssupporteddefault 300x200; paid: sides clamped to 3000 px, area to 9,000,000 px² (reported when clamped); free: capped at 1000 px per side / 1,000,000 px² and scaled down proportionally with a note in X-UrlChart-Meta (never an error)
scale, icretinasupportedscale=2 doubles the output pixels (chs=400x300 → an 800x600 image); the tier cap still applies, so a scaled free request is scaled down with a note. icretina=1/2/true is the Image-Charts alias for scale=2 and is reported in X-UrlChart-Meta
chd, chdssupportedsee data encodings
chl, chdl, chdlpsupportedlabels, legend labels, legend position (b, t, l, r); _ becomes a space. A category label wider than the canvas allows is truncated with an ellipsis and reported in X-UrlChart-Meta instead of blanking the chart; a chart whose plot area still collapses is re-rendered without labels and reported
chxt, chxl, chxrsupportedaxis declaration, per-axis labels, per-axis range/step; numeric label lists become explicit ticks, a text label list on a value axis is drawn evenly along it, and a declared axis nothing uses is reported instead of silently hidden
chxs, chxpsupportedaxis colour/size/alignment/tick marks (a repeated chxs is merged per axis and reported); chxp places a value axis' chxl labels at percentages of the axis length (default: even spacing); a category axis keeps its slots and reports the 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; negative values are honoured (the plot area may overflow the canvas)
chgsupportedgrid steps and dash pattern; a step is used only when meaningful for the data span
chdlssupportedlegend text colour and font size (<colour>,<size>)
chlisupported for doughnut chartscentre label for cht=pd/d; reported unsupported on other chart types
chfsupportedsolid, multi-stop linear gradient (lg) and repeating stripe (ls) 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
chbrsupportedrounded bar corners: one radius in pixels (Image-Charts extension); anything else is reported and leaves square corners
iclocalesupported (en, de, fr)number format only, for axis ticks and chm=N data labels: en 50,000.5, de 50.000,5, fr 50 000,5; other values are reported and use en
chmpartially supportedN data labels (bar top, inside a stack segment, above a line point), point markers (o/c/d/s/x), B/b fills, line/range markers (h/H/v/V/D/r/R) and text/flag/annotation/arrow markers (t/f/A/a); candlesticks, rectangles and error bars are accepted and ignored (degraded), and a D line marker whose point selection is a single point draws nothing and says so
chofsupportedpng (default), jpg, webp or pdf; the response Content-Type names the format, and a PDF is a one-page file that embeds the chart at its pixel size. An unknown value is reported and PNG is returned
chxtcdegradedcustom tick-mark lengths are accepted and not drawn; the note appears in X-UrlChart-Meta and in the Tester
chld, choesupported for cht=qrQR error-correction level/margin and output encoding; on other chart types they are reported unsupported
chan, chp, chty, chtmunsupportedanimated GIF, pie rotation, map type, 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.