W3cubDocs

font-variant

The font-variant CSS shorthand property allows you to set all the font variants for the fonts specified in the @font-face rule.

Constituent properties

This property is a shorthand for the following CSS properties:

Syntax

font-variant: small-caps;
font-variant: common-ligatures small-caps;

/* Global values */
font-variant: inherit;
font-variant: initial;
font-variant: unset;

Values

normal: Specifies a normal font face; each of the longhand properties has an initial value of normal. Longhand properties of font-variant are: font-variant-caps, font-variant-numeric, font-variant-alternates, font-variant-ligatures, and font-variant-east-asian.
none: Sets the value of the font-variant-ligatures to none and the values of the other longhand property as normal, their initial value.
<common-lig-values>, <discretionary-lig-values>, <historical-lig-values>, <contextual-alt-values>: Specifies the keywords related to the font-variant-ligatures longhand property. The possible values are: common-ligatures, no-common-ligatures, discretionary-ligatures, no-discretionary-ligatures, historical-ligatures, no-historical-ligatures, contextual, and no-contextual.
stylistic(), historical-forms, styleset(), character-variant(), swash(), ornaments(), annotation(): Specifies the keywords and functions related to the font-variant-alternates longhand property.
small-caps, all-small-caps, petite-caps, all-petite-caps, unicase, titling-caps: Specifies the keywords and functions related to the font-variant-caps longhand property.
<numeric-figure-values>, <numeric-spacing-values>, <numeric-fraction-values>, ordinal, slashed-zero: Specifies the keywords related to the font-variant-numeric longhand property. The possible values are: lining-nums, oldstyle-nums, proportional-nums, tabular-nums, diagonal-fractions, stacked-fractions, ordinal, and slashed-zero.
<east-asian-variant-values>, <east-asian-width-values>, ruby: Specifies the keywords related to the font-variant-east-asian longhand property. The possible values are: jis78, jis83, jis90, jis04, simplified, traditional, full-width, proportional-width, ruby.

Formal definition

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

Formal syntax

normal |
none   |
[ <common-lig-values>                      ||
  <discretionary-lig-values>               ||
  <historical-lig-values>                  ||
  <contextual-alt-values>                  ||
  stylistic(<feature-value-name>)          ||
  historical-forms                         ||
  styleset(<feature-value-name>#)          ||
  character-variant(<feature-value-name>#) ||
  swash(<feature-value-name>)              ||
  ornaments(<feature-value-name>)          ||
  annotation(<feature-value-name>)         ||
  [ small-caps      |
    all-small-caps  |
    petite-caps     |
    all-petite-caps |
    unicase         |
    titling-caps
  ]                                        ||
  <numeric-figure-values>                  ||
  <numeric-spacing-values>                 ||
  <numeric-fraction-values>                ||
  ordinal                                  ||
  slashed-zero                             ||
  <east-asian-variant-values>              ||
  <east-asian-width-values>                ||
  ruby
]

Examples

Setting the small-caps font variant

The following finds a local Open Sans font or imports it, and allows using the font for small-caps.

@font-face {
  font-family: "Open Sans";
  src: local("Open Sans") format("woff2"),
       url("/fonts/OpenSans-Regular-webfont.woff") format("woff");
  font-variant: small-caps;
}

Specifications

Specification
CSS Fonts Module Level 4 # font-variant-prop

Browser compatibility

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`font-variant`	4	12	3.5	4	10	3.1	≤37	18	4	10.1	2	1.0