$type: "fontWeight" primitive

Font Weight Token

Font weight tokens represent the visual weight of text. The $value can be a number from 100 to 900 (multiples of 100) or a keyword string such as 'thin', 'light', 'regular', 'medium', 'semibold', 'bold', 'extrabold', or 'black'. These map directly to the CSS font-weight property.

Value Format

A number (100–900) or a font weight keyword string

When to Use

Use font weight tokens to encode your type scale's weight variations — for example, separate tokens for body text, subheadings, and display headings. This enables consistent typographic hierarchy across all components.

Valid Example

Valid JSON .json

{
  "font-weight": {
    "regular": {
      "$value": 400,
      "$type": "fontWeight"
    },
    "semibold": {
      "$value": 600,
      "$type": "fontWeight"
    },
    "bold": {
      "$value": "bold",
      "$type": "fontWeight"
    }
  }
}

Paste the example above into the validator to test it yourself.

Open Validator

Related Token Types