W3cubDocs

/Web APIs

FontFaceSet: add() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨January 2020⁩.

Note: This feature is available in Web Workers.

The add() method of the FontFaceSet interface adds a new font to the set.

Syntax

add(font)

Parameters

font

A FontFace to be added to the set.

Return value

A new FontFaceSet.

Exceptions

InvalidModificationError DOMException

Thrown if this font is already included via the CSS @font-face rule.

Examples

In the following example a new FontFace object is created and then added to the FontFaceSet.

const font = new FontFace("MyFont", 'url("myFont.woff2")');
document.fonts.add(font);

Specifications

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
add 35 79 41 22 10 35 41 22 10 3.0 37 10

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/FontFaceSet/add