W3C Design Tokens
3 filesCross-tool design-token spec (DTCG/W3C). Light + dark mode siblings.
Notion is a connected workspace for notes, docs, knowledge bases, and project management — "the AI workspace that works for you." The brand voice is calm, typographic, and disciplined: black ink on warm-white paper, a tiny rounded sans wordmark, generous whitespace, and a deliberate refusal of decorative color at the institutional level. Where competing productivity brands lead with hue, Notion leads with surface and type.
Use the [email protected] brand from brand-atoms.com.
Fetch https://brand-atoms.com/dist/brands/notion/1.0.0/json/brand.json
and apply its role mappings (primary, accent, identity, etc.),
reference the fonts in references.fonts, and honor every rule where
severity is "error". Surface any deviation you choose to make.
All converter outputs for [email protected]. Served from
/dist/brands/notion/1.0.0/.
Cross-tool design-token spec (DTCG/W3C). Light + dark mode siblings.
Plain JSON mirror of the resolved brand — palette, fonts, roles, rules.
CSS custom properties on :root with prefers-color-scheme dark.
SCSS variables + Sass maps for swatches, roles, and fonts.
Tailwind v3 theme.extend.colors + fontFamily.
Figma Tokens plugin JSON (Tokens Studio compatible).
Swift enums for SwiftUI / UIKit color + font tokens.
Kotlin objects for Jetpack Compose color + typography tokens.
Human-readable brand guide. Same source as the on-page Brand Guide.
Inline rendering of the Markdown brand guide. Same source as the
markdown/brand-guide.md download.
Notion is a connected workspace for notes, docs, knowledge bases, and project management — "the AI workspace that works for you." The brand voice is calm, typographic, and disciplined: black ink on warm-white paper, a tiny rounded sans wordmark, generous whitespace, and a deliberate refusal of decorative color at the institutional level. Where competing productivity brands lead with hue, Notion leads with surface and type.
Tags: saas, productivity, notion, monochrome, minimal, ai
Notion · [email protected] · Proprietary — All Rights Reserved
Notion's brand palette — radically near-monochrome. The institutional voice is black-on-white (or white-on-black in dark mode); the brand reads as restrained, typographic, and surface-driven. Where competing productivity brands lead with color, Notion leads with whitespace and type. This atom captures only the verified mark and surface tones; in the product, additional accent colors exist for callouts and tags but those are not published as brand-level hex values and are not catalogued here to avoid fabrication.
| Role | Font | License | Classification |
|---|---|---|---|
heading |
Inter ([email protected]) |
OFL-1.1 | sans-serif |
body |
Inter ([email protected]) |
OFL-1.1 | sans-serif |
mono |
JetBrainsMono Nerd Font ([email protected]) |
OFL-1.1 | monospace |
| ID | Name | Value |
|---|---|---|
notion-black |
Notion Black | #000000 |
notion-white |
Notion White | #FFFFFF |
notion-canvas-dark |
Notion Canvas Dark | #191919 |
notion-surface-dark |
Notion Surface Dark | #2F2F2F |
notion-text-secondary-light |
Notion Text Secondary (Light) | #787878 |
notion-text-tertiary-light |
Notion Text Tertiary (Light) | #A0A0A0 |
notion-text-secondary-dark |
Notion Text Secondary (Dark) | #A0A0A0 |
| Role | Swatch | Hex |
|---|---|---|
background |
notion-white |
#FFFFFF |
surface |
notion-white |
#FFFFFF |
surface-elevated |
notion-white |
#FFFFFF |
text-primary |
notion-black |
#000000 |
text-secondary |
notion-text-secondary-light |
#787878 |
text-tertiary |
notion-text-tertiary-light |
#A0A0A0 |
primary |
notion-black |
#000000 |
primary-hover |
notion-text-secondary-light |
#787878 |
accent |
notion-black |
#000000 |
accent-hover |
notion-text-secondary-light |
#787878 |
warning |
notion-black |
#000000 |
warning-hover |
notion-text-secondary-light |
#787878 |
error |
notion-black |
#000000 |
success |
notion-black |
#000000 |
| Role | Swatch | Hex |
|---|---|---|
background |
notion-canvas-dark |
#191919 |
surface |
notion-surface-dark |
#2F2F2F |
surface-elevated |
notion-surface-dark |
#2F2F2F |
text-primary |
notion-white |
#FFFFFF |
text-secondary |
notion-text-secondary-dark |
#A0A0A0 |
text-tertiary |
notion-text-tertiary-light |
#A0A0A0 |
primary |
notion-white |
#FFFFFF |
primary-hover |
notion-text-secondary-dark |
#A0A0A0 |
accent |
notion-white |
#FFFFFF |
accent-hover |
notion-text-secondary-dark |
#A0A0A0 |
warning |
notion-white |
#FFFFFF |
warning-hover |
notion-text-secondary-dark |
#A0A0A0 |
error |
notion-white |
#FFFFFF |
success |
notion-white |
#FFFFFF |
| Role | Swatch | Hex |
|---|---|---|
identity |
notion-black |
#000000 |
on-identity |
notion-white |
#FFFFFF |
primary |
notion-black |
#000000 |
primary-hover |
notion-text-secondary-light |
#787878 |
accent |
notion-black |
#000000 |
accent-hover |
notion-text-secondary-light |
#787878 |
success |
notion-black |
#000000 |
warning |
notion-black |
#000000 |
error |
notion-black |
#000000 |
background-light |
notion-white |
#FFFFFF |
background-dark |
notion-canvas-dark |
#191919 |
surface-light |
notion-white |
#FFFFFF |
surface-dark |
notion-surface-dark |
#2F2F2F |
text-primary-light |
notion-black |
#000000 |
text-primary-dark |
notion-white |
#FFFFFF |
| Role | Font role key |
|---|---|
display |
heading |
prose |
body |
code |
mono |
colorChoice → logo.markThe Notion mark is monochrome by definition. Use black on light surfaces or white on dark surfaces — never a colored variant.
forbiddenTreatment → logoThe Notion mark's reading depends on clean black/white contrast against a quiet surface. Effects, recoloring, and busy backgrounds break the mark's institutional voice.
contrastRatio → text-primarybackground4.5WCAG-AAWCAG 2.1 Level AA contrast minimum for body text — the floor below which the surface no longer reads as Notion.
contextRestriction → roles.colors.identityNotion's trademark and brand guidance restrict use of the mark in ways that imply endorsement or appear on competing-product surfaces without explicit license.
accessibilityRequirement → *WCAG-AA1.4.3WCAG 2.1 Success Criterion 1.4.3 (Contrast Minimum) — Level AA. Notion's pure-black-on-white default starts well above AA; Notion-skinned surfaces must hold that floor.
contrastRatio → text-primarybackground7WCAG-AAANotion's pure-black-on-white identity sits at 21:1 contrast — well above AAA's 7:1 floor. Skinning that drops below AAA on body text would betray the brand's documented commitment to legibility.
numericRatio → typography.body.lineHeight1.51.7Notion's product surface reads with generous line-height — typically in the 1.5–1.7 band. Tighter values break the calm typographic rhythm; looser values feel decorative.
Proprietary — All Rights Reserved2026-05-17Generated by the brand-atoms converter. Source: [email protected] from the encyclopedia.
Every block below renders from the resolved palette + font references on this brand. Swap the brand and the same template re-themes — no per-brand component code required.
Body copy renders in the brand's prose font on the brand's background.
Inline links and highlighted phrases pick up
the brand's primary and highlight roles. Code spans like brand.references.palette
fall back to the monospace face.
A blockquote uses the brand's accent color as its rule. Useful for pulling tagline copy out of running prose.
Neutral status — provides supplemental context without urgency. Uses the brand's primary as the rule.
Confirms a completed action — palette role success determines the rule color.
Calls out something that needs attention but isn't an error — palette role warning.
Surfaces a failure that blocks progress — palette role error. Use sparingly.
| Role | Resolves to | Mode |
|---|---|---|
| primary | brand color #1 | light + dark |
| accent | brand color #2 | light + dark |
| warning | brand warning | light + dark |
| error | brand error | light + dark |
Brand-level role overrides on top of palette-default mappings. Each role resolves to a concrete swatch or font reference.
→ notion-black #000000 → notion-text-secondary-light #787878 → notion-canvas-dark #191919 → notion-white #FFFFFF → notion-black #000000 → notion-black #000000 → notion-white #FFFFFF → notion-black #000000 → notion-text-secondary-light #787878 → notion-black #000000 → notion-surface-dark #2F2F2F → notion-white #FFFFFF → notion-white #FFFFFF → notion-black #000000 → notion-black #000000 → mono JetBrainsMono Nerd Font → heading Inter → body Inter → notion-black → notion-text-secondary-light → notion-white → notion-black → notion-black → notion-text-secondary-light → notion-black → notion-white → notion-white → notion-black → notion-text-secondary-light → notion-text-tertiary-light → notion-black → notion-text-secondary-light → notion-white → notion-text-secondary-dark → notion-canvas-dark → notion-white → notion-white → notion-text-secondary-dark → notion-white → notion-surface-dark → notion-surface-dark → notion-white → notion-text-secondary-dark → notion-text-tertiary-light → notion-white → notion-text-secondary-dark colorChoice logo.mark allowed notion-black, notion-white forbidden any-non-brand-color The Notion mark is monochrome by definition. Use black on light surfaces or white on dark surfaces — never a colored variant.
forbiddenTreatment logo treatments stretched, rotated, recolored, drop-shadow, on-busy-photo, gradient-fill The Notion mark's reading depends on clean black/white contrast against a quiet surface. Effects, recoloring, and busy backgrounds break the mark's institutional voice.
contrastRatio text-primary against background minRatio 4.5 standard WCAG-AA WCAG 2.1 Level AA contrast minimum for body text — the floor below which the surface no longer reads as Notion.
contextRestriction roles.colors.identity forbiddenContexts decorative-only, product-of-competitor, endorsement-implication Notion's trademark and brand guidance restrict use of the mark in ways that imply endorsement or appear on competing-product surfaces without explicit license.
accessibilityRequirement * standard WCAG-AA criterion 1.4.3 WCAG 2.1 Success Criterion 1.4.3 (Contrast Minimum) — Level AA. Notion's pure-black-on-white default starts well above AA; Notion-skinned surfaces must hold that floor.
contrastRatio text-primary against background minRatio 7 standard WCAG-AAA Notion's pure-black-on-white identity sits at 21:1 contrast — well above AAA's 7:1 floor. Skinning that drops below AAA on body text would betray the brand's documented commitment to legibility.
numericRatio typography.body.lineHeight min 1.5 max 1.7 Notion's product surface reads with generous line-height — typically in the 1.5–1.7 band. Tighter values break the calm typographic rhythm; looser values feel decorative.
Proprietary — All Rights Reserved2026-05-17