`font-variation-settings` CSS at-rule descriptor

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

See full compatibility

The font-variation-settings CSS descriptor allows authors to specify low-level OpenType or TrueType font variations in the @font-face at-rule. The values for this descriptor are the same as the font-variation-settings property, except for the global keyword values.

Since this descriptor sets variation values on the font object in the @font-face at-rule and not on an entire element, only some glyphs in an element may be rendered using this descriptor.

Syntax

css

/* Use the default settings */
font-variation-settings: normal;

/* Set values for OpenType axis names */
font-variation-settings: "xhgt" 0.7;

Values

normal: Text is laid out using default settings.
<string> <number>: When rendering text, the list of OpenType axis names is passed to the text layout engine to enable or disable font features. Each setting is always a <string> of 4 ASCII characters, followed by a <number> indicating the axis value. If the <string> has more or fewer characters or contains characters outside the U+20 - U+7E code point range, the whole property is invalid. The <number> can be fractional or negative.

Formal definition

Related at-rule	`@font-face`
Initial value	`normal`
Computed value	as specified

Formal syntax

font-variation-settings = 
  normal                  |
  [ <string> <number> ]#

Examples

Setting font weight and stretch in a @font-face rule

css

@font-face {
  font-family: "OpenTypeFont";
  src: url("open_type_font.woff2") format("woff2");
  font-weight: normal;
  font-style: normal;
  font-variation-settings:
    "wght" 400,
    "wdth" 300;
}

Specifications

Specification
CSS Fonts Module Level 4 # font-rend-desc

Browser compatibility

	desktop					mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS
`font-variation-settings`	Chrome – Full support Chrome 140 (Release date: 2025-09-02) footnote Full support	Edge – Full support Edge 140 (Release date: 2025-09-05) footnote Full support	Firefox – Full support Firefox 62 (Release date: 2018-09-05) footnote Full support	Opera – Full support Opera 124 (Release date: 2025-11-13) footnote Full support	Safari – No support Safari footnote No support	Chrome Android – Full support Chrome Android 140 (Release date: 2025-09-02) footnote Full support	Firefox for Android – Full support Firefox for Android 62 (Release date: 2018-09-05) footnote Full support	Opera Android – Full support Opera Android 92 (Release date: 2025-10-08) footnote Full support	Safari on iOS – No support Safari on iOS footnote No support	Samsung Internet – No support Samsung Internet footnote No support	WebView Android – Full support WebView Android 140 (Release date: 2025-09-02) footnote Full support	WebView on iOS – No support WebView on iOS footnote No support

Tip: you can click/tap on a cell for more information.

Full support: Full support
No support: No support

font-variation-settings CSS at-rule descriptor

Legend

`font-variation-settings` CSS at-rule descriptor