Skip to main content

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:

brandKitIdDescription
obsidianDark background (#0d1117), emerald first series
linenWarm off-white background, orange first series
polarWhite background, blue first series
studioDark purple background, purple and pink series
emberWarm off-white background, orange series
harborPale mint background, teal-green series
json
{ "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

  1. Go to Brand Kits in your dashboard
  2. Create a kit by hand, or paste your website address to draft one from its colors, font, and logo
  3. Review the colors, font, and logo, then save
  4. The kit gets a slug (for example acme) to use as brand in render requests

Via the API

json
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

json
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

json
{ "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.

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.

json
{ "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:

  1. Per-request theme — highest priority
  2. Brand kit (preset or saved UUID)
  3. Template defaults (when using a template)
  4. Raw Chart.js values in your spec
  5. System defaults — lowest priority

Saved kit fields

FieldRequiredDescription
nameyesHuman-readable name, up to 80 characters
slugnoLowercase letters, digits and hyphens, up to 48 characters. Made from the name when omitted. Used as brand in render requests
paletteno2 to 10 hex colors; the first is the main series color
backgroundnoCard and chart background color (hex)
textColornoText color (hex). The API warns when it is too faint against the background
gridColornoHex or rgba() color for grid lines
fontnoInter (default), Roboto, Montserrat, DM Sans, Plus Jakarta Sans, Source Sans 3, Lato, Open Sans, Merriweather, or Playfair Display
logoUrlnoHTTPS URL fetched once and re-hosted; null removes the logo. Or send logoData as a base64 data: URL
logoPositionnotop-left, top-right, bottom-left, bottom-right, or none
defaultsnolegendPosition, borderRadius (0–24), gridlines, locale
primaryColor, accentColornoOlder fields, still accepted: the first two palette colors
mode, gridStyle, rounding, logoAlign, logoHeightnoOlder fields, still accepted

Related walkthroughs