Font-width CSS property and @font-face descriptor docs are missing

[pepelsbey]

BCD

• Support for the font-width property added in Safari 18.4 (31.03.2025)
• Support for the font-width descriptor added in Safari 26 (15.09.2025)

It’s a little tricky because it’s a new name for an old property/descriptor.

MDN

• font-stretch property
  Marked as deprecated, font-width is mentioned as “not yet supported by any browsers”.
• font-stretch descriptor
  Marked as deprecated, font-width is not mentioned.

Spec

• Property: Font width: the font-stretch legacy name alias
• Descriptor: Font width: the font-stretch legacy name alias

[amit-kr-ghosh]

I’d like to work on this.

From my understanding:

• font-width is now a legacy alias of font-stretch
• Safari has added support for the property (18.4) and descriptor (26)
• MDN pages currently either mark it as unsupported or don’t mention it

Proposed fix (after confirmation):

• Update font-stretch property page to document font-width as a legacy alias
• Update @font-face descriptor docs to mention font-width
• Align browser compatibility data accordingly

Please confirm if this approach is correct before I open a PR.

[pepelsbey]

It's the other way around: font-width is new and barely supported, font-stretch is legacy and well-supported.

[Josh-Cena]

Traditionally, feature renames with little to no semantic change are just fixed by a page move and a mention of the legacy alias. There's no need to apply 2-year rules or similar.