szum

Quick Start

Render your first szum chart in 30 seconds – one URL in, one publication-ready image out, no setup required.

Embed a chart right now

This URL is a chart. Paste it into your browser:

https://szum.io/chart?config={"version":"2026-03-20","format":"svg","title":"Weekly Signups","subtitle":"New accounts, March 2026","y":{"label":"Signups"},"marks":[{"type":"barY","data":[{"x":"Mon","y":120},{"x":"Tue","y":150},{"x":"Wed","y":180},{"x":"Thu","y":140},{"x":"Fri","y":200}]}]}

You get back an SVG. That's it. No API key, no sign-up.

The same URL works in an <img> tag, a Markdown file, a Notion page, an email, a Slack message – anywhere images render:

<img src='https://szum.io/chart?config={"version":"2026-03-20","format":"svg","title":"Weekly Signups","subtitle":"New accounts, March 2026","y":{"label":"Signups"},"marks":[{"type":"barY","data":[{"x":"Mon","y":120},{"x":"Tue","y":150},{"x":"Wed","y":180},{"x":"Thu","y":140},{"x":"Fri","y":200}]}]}' />

Change a theme

One property transforms the entire chart – typography, colors, axes, grid:

Six themes ship built-in. Create your own theme by overriding the default properties. See Themes.

Layer marks

Add a second mark to the same chart. Later marks draw on top of earlier ones:

Bars + rules, lines + dots, areas + text – marks compose freely.

Use the API for production

GET embeds are free and keyless, but limited to 200 renders per month per IP. For production use, install the TypeScript SDK or send POST requests with an API key:

import { Szum } from "@szum-io/sdk";

const szum = new Szum({ apiKey: "YOUR_API_KEY" });
const svg = await szum.render({
  format: "svg",
  theme: "editorial",
  marks: [{ type: "barY", data: [{ x: "Q1", y: 42 }, { x: "Q2", y: 58 }] }],
});

Sign up at szum.io/sign-up to get an API key. The free plan includes 1,337 renders per month. See Authentication and Plans.

Learn more

On this page