Cómo escribir @font-face en CSS: orden woff2, woff y ttf

Contenido
Para descargar un archivo de fuente web y aplicarlo a tu sitio tienes que escribir una regla @font-face, y justo ahí aparecen las dudas de siempre: en qué orden hay que listar woff2, woff y ttf dentro de src, y por qué font-family necesita comillas. Ese orden y esa sintaxis no son convenciones arbitrarias: son reglas que salen de cómo lee el CSS el propio navegador. Vamos a repasar ese funcionamiento paso a paso, centrándonos en la estructura del código.
Resumen ① La lista de src va fija en woff2 → woff → truetype porque el navegador la lee de arriba abajo y se detiene en el primer formato que admite. ② En font-family, envolver el nombre entre comillas es más seguro para evitar conflictos con espacios y palabras reservadas. ③ font-display: swap muestra primero el texto con una fuente sustituta mientras la fuente carga y, al terminar, lo cambia por la que has indicado.
Cuando ya tienes los tres archivos de fuente web, aquí es donde te atascas
Si usas un sitio o una herramienta que convierte fuentes para la web, normalmente obtienes tres archivos a la vez: .woff2, .woff y .ttf. Como cada navegador admite formatos distintos, no basta con incluir uno: hay que enlazar los tres en el CSS.
El problema empieza justo ahí. En cada ejemplo que sale al buscar, el orden dentro de src es distinto, y algunos ponen el ttf arriba del todo. Si cambias el orden, el navegador no muestra ningún error: carga la fuente en silencio, así que a simple vista cuesta ver qué está mal.
Con las comillas de font-family pasa lo mismo, y también con si puedes poner en font-weight un valor distinto al del archivo real. El resultado suele ser una pantalla ambigua en la que «parece que se aplicó, pero también parece la fuente de siempre».
Cómo escribir el código @font-face a mano, sin herramientas
La regla @font-face declara un nombre de fuente y le asocia una lista de archivos (src) y la información de grosor y estilo. Su forma básica es esta.
@font-face {
font-family: "Pretendard";
src: url("/fonts/pretendard.woff2") format("woff2"),
url("/fonts/pretendard.woff") format("woff"),
url("/fonts/pretendard.ttf") format("truetype");
font-weight: 400;
font-style: normal;
font-display: swap;
}
Veamos uno por uno por qué el orden y la sintaxis tienen que ser así dentro de esta estructura.
Por qué el orden de src queda fijo en woff2 → woff → truetype
En la propiedad src puedes listar varios pares url() y format() separados por comas. El navegador recorre esa lista de arriba abajo y, en cuanto encuentra el primer formato que admite, descarga solo ese archivo e ignora el resto.
Así que el orden de la lista es el orden de prioridad. WOFF2 comprime mejor y por eso pesa menos, WOFF es más antiguo pero está más extendido y TTF (TrueType) es el formato de respaldo más viejo. Si pones woff2 arriba, los navegadores que lo admiten descargan el archivo más ligero, y solo los entornos que no lo admiten pasan a la línea siguiente, a woff, y si tampoco pueden, a ttf.
Si inviertes el orden y pones el ttf arriba, como casi todos los navegadores admiten ttf, la lista se detiene en la primera línea. El resultado es que incluso los navegadores modernos, que ya admiten woff2, acaban descargando el ttf más pesado. Para el navegador no es un error: ha seguido al pie de la letra el orden indicado, así que ni siquiera aparece un aviso en la consola.
Por qué se usan comillas en font-family
El valor de font-family se puede escribir de dos maneras en CSS: sin comillas, como identificador, o entre comillas, como cadena de texto (string).
Si lo escribes como identificador, un nombre con espacios puede interpretarse dividido en varias palabras, y un nombre que empieza por un número o que coincide con una palabra reservada de CSS como sans-serif o inherit puede acabar en un error de análisis. Entre comillas, el nombre completo llega como una sola cadena de texto, sin esos problemas.
Por eso es buena costumbre poner comillas aunque el nombre de la fuente no tenga espacios. Es también la razón de las comillas en «Pretendard» del ejemplo anterior.
Qué hace realmente font-display: swap en el renderizado
font-display es la propiedad que decide cómo muestra el navegador el texto durante el breve tiempo en que el archivo de fuente web aún no se ha descargado. Con el valor swap, el navegador no espera a la fuente: dibuja el texto de inmediato con una fuente sustituta (la fuente de respaldo).
Después, cuando el archivo de fuente web indicado termina de cargar, reemplaza el texto ya dibujado por esa fuente. Si no indicas font-display, según el comportamiento por defecto del navegador puede aparecer un periodo de espera en el que el texto no se ve hasta que la fuente carga; swap elimina prácticamente esa espera y hace que el texto se vea siempre primero.
Eso sí, si el ancho de los caracteres de la fuente de respaldo y el de la fuente real no coinciden, al hacer el cambio puedes ver un pequeño movimiento en los saltos de línea o en la disposición. swap se usa cuando prefieres que el texto aparezca de inmediato antes que verlo aparecer tarde.
Aunque ya conozcas la estructura —el orden de src, las comillas, font-display—, escribir a mano cada vez el nombre de la fuente y las tres rutas de archivo es un fastidio. Puedes comprobar todo este proceso directamente con nuestro Generador de CSS @font-face, que genera al momento el código @font-face para WOFF2, WOFF y TTF indicando familia, grosor y rutas.
Solo tienes que indicar el nombre de la fuente y las rutas de los archivos: el código @font-face con el orden correcto se genera al momento. Todo se procesa en tu navegador, sin enviar nada al servidor.

Tres errores que hacen que la fuente no se vea
Aunque el código parezca funcionar sin errores de sintaxis, cuando la fuente no se aplica casi siempre es por uno de estos tres motivos.
| Error | Qué ocurre |
|---|---|
| Escribir el orden de src al revés (ttf arriba del todo) | Incluso los navegadores modernos se detienen en la primera línea y descargan el ttf, que pesa más |
| Que el nombre de format() no coincida con la extensión real del archivo | El navegador se guía solo por la pista y se salta esa línea o no consigue leer el archivo |
| Que font-weight y font-style no coincidan con el archivo real | Al buscar el texto con el grosor y el estilo declarados, esta fuente no coincide y se usa en su lugar la fuente de respaldo o una negrita sintetizada |
El nombre de format() es una pista que el navegador consulta antes de abrir el archivo. Si el archivo es en realidad .woff2 y escribes format("woff"), el navegador puede interpretar esa línea como un formato que no admite, saltársela y pasar a la siguiente. Es el caso de un archivo perfectamente válido que no se carga porque la etiqueta del código está equivocada.
Con font-weight pasa lo mismo. El navegador no abre el archivo para comprobar su grosor real: se cree el número que pone en el CSS. Si subes un archivo Bold y lo declaras con font-weight: 400, el texto que pide font-weight: 700 no se conectará a esta fuente y se usará en su lugar la fuente de respaldo o una negrita que el navegador sintetice por su cuenta.
En resumen
- El orden de src no es una convención: queda fijo en woff2 → woff → truetype por el principio de funcionamiento de detenerse en el primer formato que el navegador admite.
- En font-family, envolver el nombre entre comillas es más seguro para evitar conflictos con espacios y palabras reservadas.
- font-display: swap consiste en mostrar primero el texto con una fuente sustituta y cambiarla después, sin esperar a que cargue la fuente.
- El valor de format() debe coincidir exactamente con la extensión real del archivo, y font-weight y font-style con el grosor y el estilo reales, para que la fuente se conecte bien.
- Si respetas estas cuatro cosas, puedes escribir tú mismo un código @font-face correcto sin ninguna herramienta adicional.
Solo tienes que indicar el nombre de la fuente y las rutas de los archivos: el código @font-face con el orden correcto se genera al momento. Todo se procesa en tu navegador, sin enviar nada al servidor.
Preguntas frecuentes
¿Puedo incluir solo un archivo woff2?
Sí, siempre que limites la compatibilidad a los navegadores más recientes. Pero si quieres cubrir también navegadores antiguos, lo más seguro es añadir woff como respaldo, y ttf es un formato que solo conviene sumar cuando necesitas dar soporte a entornos muy antiguos.
¿Tengo que escribir el nombre del archivo tal cual dentro de format()?
No. En format() se usan los valores definidos por la especificación de CSS (woff2, woff, truetype, opentype, etc.). Eso sí, el valor debe coincidir con el formato real del archivo: si es un archivo .ttf, se usa format("truetype"), y si es un archivo .otf, format("opentype").
¿Cómo declaro varios archivos de fuente con grosores distintos?
Con el mismo nombre de font-family, declara una regla @font-face aparte para cada archivo con grosor diferente. Si declaras el archivo Regular con font-weight: 400 y el archivo Bold con font-weight: 700, el navegador elegirá la regla que coincida con el valor de font-weight que realmente se esté usando.
¿Hay otros valores para font-display además de swap?
Existen cinco valores: auto, block, swap, fallback y optional. Con block el navegador espera un momento breve a la fuente y luego pinta el texto; con swap no espera y pinta primero con una fuente sustituta para después cambiarla. Si quieres mostrar el texto cuanto antes, usa swap; si prefieres reducir ese efecto de cambio repentino cuando la fuente termina de cargar, valora block.
Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano