Ant Design font family stack
The recommended font family for Ant Design, prioritizing system default UI fonts with fallbacks for cross-platform consistency: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, 'Noto Sans', sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji'.
Tabular figures for numbers in admin systems
In admin and data-heavy systems, the CSS font-variant-numeric property should be set to 'tabular-nums' to ensure numbers display as fixed-width characters for vertical comparison.
Ant Design base font size
The primary font size in Ant Design is 14px, upgraded from the previous 12px. This sizing is based on optimal viewing distance (50cm) and viewing angle (0.3 degrees) for monitor displays to maximize reading efficiency.
Primary line height for 14px font
The recommended line height corresponding to the primary 14px font size is 22px.
Font weight options in Ant Design
Font weights in Ant Design follow three main options: regular (400), medium (500) for most text, and semibold (600) for bold emphasis in English text. Multiple weights are used sparingly to maintain order and restraint.
Recommended font scale limit
Within a single design system (excluding landing pages), limit font size choices to 3-5 different sizes from the available font scale to maintain visual restraint and consistency.
WCAG contrast standard for text colors
Text colors in Ant Design maintain a contrast ratio of 7:1 or higher (AAA level) between body text, headings, and background colors, following WCAG accessibility standards.
Five pillars of Ant Design typography system
The Ant Design typography system is built on five key aspects: 1) font family selection, 2) primary font size, 3) font scale and line height, 4) font weight, and 5) text color.
Typography system design philosophy
The Ant Design font system is based on the principle of dynamic order, inspired by natural logarithms and musical harmony, refined through extensive testing in Ant Design products for admin and enterprise use.
Font scale uses 10 different sizes
Ant Design defines 10 different font sizes and corresponding line heights, inspired by the pentatonic scale and natural ratios.
Base font size and rationale
The base font size is 14 px, not 16 px. Enterprise consoles trade legibility headroom for information density. At 14 px, a row of body copy reaches the eye-saccade sweet spot of approximately 75 characters at the column widths that dense layouts demand.
Font stack priority
The font stack prioritizes the OS UI font in order: Apple's -apple-system, then BlinkMacSystemFont, then Windows' Segoe UI, then Android/ChromeOS' Roboto, then Helvetica Neue, then Arial, with Noto Sans covering Linux. The code font uses SFMono-Regular, Consolas, Liberation Mono, Menlo, and Courier in the same order.
Font weights used in Ant Design
Only two font weights appear in product UI: 400 (body, controls, menu items, tab labels) and 600 (fontWeightStrong for headings, table headers, and title-grade typography). Thin (100–300), bold (700+), and italics are not used in interface chrome. Italics are acceptable only inside long-form documentation prose. Visual emphasis on selected/active states comes from color and stroke (border, underline), not weight.
Typography scale details
Ant Design typography includes: display-lg (38px, 600 weight, 46px line-height), headline-lg (30px, 600 weight, 38px line-height), headline-md (24px, 600 weight, 32px line-height), headline-sm (20px, 600 weight, 28px line-height), title-lg (16px, 600 weight, 24px line-height), title-md (14px, 600 weight, 22px line-height), body-lg (16px, 400 weight, 24px line-height), body-md (14px, 400 weight, 22px line-height), body-sm (12px, 400 weight, 20px line-height), and code (13px, 400 weight, 20px line-height). All use the same font family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, 'Noto Sans', sans-serif, except code which uses 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, Courier, monospace.
Typography actions placement prop
Typography supports `actions` placement prop added in version 6.4.0 to control the position of action buttons.