Skip to content

Number

Token type$type: number2026-11-09

A unitless number for opacity, ratios and multipliers.

Value format

{ "$type": "number", "$value": 0.8 }

A raw JSON number. A string such as "0.8" is refused as $value.

In Syntope Tokens

Type a number such as 0.8, -3 or 1e-3, or a reference. A leading + and units are refused.

Applying to layers

Apply token offers the group general (opacity, rotation, layout grow) and every dimension target.

  • opacity is clamped to 0–1, so 80 sets 1, not 80%. Use 0.8.
  • layout grow takes only 0 or 1.
  • Figma keeps rotation between -180 and 180, so 270 reads back as -90.
  • On a dimension target the number counts as pixels. 12 on width sets 12.

Figma variables

Maps to a FLOAT variable, except for a marked line height (below).

Line height tokens

A number can carry a Syntope marker that makes the line height target use a percentage or auto:

{
"$type": "number",
"$value": 1.5,
"$extensions": { "eu.syntope.figma": { "lineHeight": { "unit": "PERCENT" } } }
}
Marker line height becomes The token shows
PERCENT $value × 100 percent 150%
AUTO Auto. $value is fixed at 1.2 for other tools AUTO

A Tokens Studio import creates these markers. The dialog cannot add one to a new token, so add it in the JSON editor. On a marked token the field accepts 175% or AUTO. On a PERCENT token a bare number also counts as percent.

For a line height in pixels, use a dimension token.

A marked number is left out of variable sync, because a Figma number variable has no percentage or auto. Apply it to layers directly.