Design glossaryFont weight is how thick a typeface's strokes are, from thin to black. In CSS it usually runs from 100 to 900, where 400 is normal and 700 is bold.
Font weight describes how heavy the letters of a typeface look, which comes down to the thickness of their strokes. A typeface family may include a hairline-thin cut, a heavy black cut, and several weights in between, all sharing the same letter shapes.
Weight is one of the main tools of typographic hierarchy. A bold heading over regular body text tells readers what to read first without any change in size or color.
Weight names and numbers
Type foundries name weights inconsistently, so CSS uses numbers. The common mapping is:
| Value | Common names |
|---|---|
| 100 | Thin, Hairline |
| 200 | Extra Light, Ultra Light |
| 300 | Light |
| 400 | Regular, Normal |
| 500 | Medium |
| 600 | Semibold, Demibold |
| 700 | Bold |
| 800 | Extra Bold, Ultra Bold |
| 900 | Black, Heavy |
In CSS, font-weight: normal equals 400 and bold equals 700. Variable fonts have a continuous weight axis, so they accept in-between values such as 450 or 650 within the range the font supports.
How browsers handle weights
A browser can only show a weight it has a font file for. With static fonts, each weight (and its italic) is a separate file to download. If a page asks for a weight that is not loaded, the browser picks the nearest one, and if no bold is available it may fake one by thickening the regular weight, which usually looks smudged.
That has a performance cost to manage. Every extra static weight adds a download, so most sites are better off loading two or three weights, typically regular, a semibold or bold, and perhaps one for display headings. A variable font covers the whole range in one file, which is often smaller than three or four static files together.
Choosing weights
- Body text: regular (400) is usually right. Light weights look elegant in large headings but thin out at small sizes, especially on low-resolution screens, and gray text in a light weight can fail contrast checks.
- Headings: semibold or bold separates them from body text. Very large display headings can go lighter, because size already gives them weight.
- Emphasis: use bold sparingly inside paragraphs. When everything is bold, nothing stands out.
- Pairing: a clear jump, such as 400 against 700, reads as intentional. Weights only one step apart, such as 400 and 500, can look like a mistake.
Font weight in WordPress
Block themes register fonts, and the weights each one includes, in theme.json. Site owners can add fonts and choose weights in the Font Library under Styles, Typography, and editors pick a weight for a block through its Appearance setting in the Typography panel. Only weights the theme actually loads will look right, so check that the weights offered there have font files behind them, including italic versions if editors use italics.