Brand Kits
Apply consistent colors, fonts, logos, and styling across every chart — without touching each spec. Six built-in presets, plus custom kits you manage via the dashboard or API.
Built-in presets
Pass the preset name directly as brandKitId — no dashboard setup required:
| brandKitId | Description |
|---|---|
| obsidian | Dark background (#0d1117), emerald first series |
| linen | Warm off-white background, orange first series |
| polar | White background, blue first series |
| studio | Dark purple background, purple and pink series |
| ember | Warm off-white background, orange series |
| harbor | Pale mint background, teal-green series |
{
"type": "bar",
"brandKitId": "obsidian",
"data": {
"labels": ["Jan", "Feb", "Mar", "Apr"],
"datasets": [{ "label": "Revenue", "data": [12000, 15000, 18000, 22000] }]
}
}Custom brand kits
Saved kits belong to your account. The number you can use depends on your plan: 1 on Free, 3 on Pro, and 15 on Agency, with each extra kit on Agency $5 a month. If a downgrade leaves you with more kits than your plan includes, the extra ones are kept read-only and rendering with one returns a 403 with plan_required.
Via the dashboard
- Go to Brand Kits in your dashboard
- Create a kit by hand, or paste your website address to draft one from its colors, font, and logo
- Review the colors, font, and logo, then save
- The kit gets a slug (for example
acme) to use asbrandin render requests
Via the API
POST /api/v1/brand-kits
{
"name": "Acme Corp",
"slug": "acme",
"palette": ["#e85729", "#3a6cf5", "#0f9d72"],
"background": "#ffffff",
"textColor": "#1f2937",
"font": "Inter",
"logoUrl": "https://acme.com/logo.png",
"logoPosition": "top-right"
}Only name is required. The response includes the kit's id (UUID) and slug.
From a website
POST /api/v1/brand-kits/from-url
{ "url": "https://acme.com", "slug": "acme", "save": true }Drafts a kit from the site's colors, font, and logo. Without save the draft is only returned; with save: true it is also stored under the same rules as POST /api/v1/brand-kits. The result is a draft to check, not a guaranteed match. Each plan has a monthly allowance of these: 1 on Free, 10 on Pro, 50 on Agency.
Using a saved kit
{ "type": "bar", "brand": "acme", "data": { ... } }brand takes the kit's slug and needs an API key. An unknown slug returns a 404 listing the slugs your account has, never a silent fallback. You can also pass the kit's UUID as brandKitId; an unknown UUID renders without a kit.
Logo
A saved kit's logo is fetched (or uploaded) once, when you save the kit, checked, and re-hosted in our storage. Renders use the stored copy, so a later change at your website does not alter your charts. The logo appears in the header of full-card compositions.
- PNG or SVG, up to 500 KB. The file is identified by its contents, not its extension.
- SVGs that contain scripts, embedded HTML, or event handlers are refused.
logoUrlmust be HTTPS. Private and loopback addresses are blocked.logoPositionistop-left,top-right,bottom-left,bottom-right, ornone.
You can also set a logo for a single request with header.logoUrl, without a brand kit. That URL is fetched at render time, and logoHeight (16–120 px) and logoAlign (left or right) apply to it.
{
"type": "bar",
"width": 800,
"height": 480,
"brand": "acme",
"header": {
"eyebrow": "Q4",
"title": "Monthly Revenue",
"logoUrl": "https://acme.com/logo.png",
"logoHeight": 28,
"logoAlign": "right"
},
"data": {
"labels": ["Jan", "Feb", "Mar"],
"datasets": [{ "label": "Revenue", "data": [12000, 15000, 18000] }]
}
}Per-request theme override
The theme object lets you override any brand-kit token on a per-render basis. Useful when a preset is close but you need a custom background or palette for a specific chart.
{
"type": "line",
"brandKitId": "polar",
"theme": {
"backgroundColor": "#0f172a",
"palette": ["#60a5fa", "#34d399", "#f472b6"],
"mode": "dark"
},
"data": { ... }
}Theme precedence chain
When multiple sources define the same token, the highest-priority source wins:
- Per-request
theme— highest priority - Brand kit (preset or saved UUID)
- Template defaults (when using a template)
- Raw Chart.js values in your spec
- System defaults — lowest priority
Saved kit fields
| Field | Required | Description |
|---|---|---|
| name | yes | Human-readable name, up to 80 characters |
| slug | no | Lowercase letters, digits and hyphens, up to 48 characters. Made from the name when omitted. Used as brand in render requests |
| palette | no | 2 to 10 hex colors; the first is the main series color |
| background | no | Card and chart background color (hex) |
| textColor | no | Text color (hex). The API warns when it is too faint against the background |
| gridColor | no | Hex or rgba() color for grid lines |
| font | no | Inter (default), Roboto, Montserrat, DM Sans, Plus Jakarta Sans, Source Sans 3, Lato, Open Sans, Merriweather, or Playfair Display |
| logoUrl | no | HTTPS URL fetched once and re-hosted; null removes the logo. Or send logoData as a base64 data: URL |
| logoPosition | no | top-left, top-right, bottom-left, bottom-right, or none |
| defaults | no | legendPosition, borderRadius (0–24), gridlines, locale |
| primaryColor, accentColor | no | Older fields, still accepted: the first two palette colors |
| mode, gridStyle, rounding, logoAlign, logoHeight | no | Older fields, still accepted |