Hreflang: la guía completa, con datos de 78 grandes sitios web

Esta guía explica la sintaxis, las tres formas de implementarlo, las reglas que rompen la mayoría de las configuraciones, la relación con la etiqueta canonical y una prueba que puede hacer en su sitio en 10 minutos. Incluye también datos de nuestra auditoría de 123 grandes sitios web: 78 páginas de inicio legibles muestran cómo lo resuelven las grandes marcas en la práctica.

Qué hace hreflang y qué no hace

Un sitio con una página en francés y otra en inglés sobre el mismo producto plantea un problema al buscador: ve dos páginas y debe decidir cuál mostrar a cada persona. Hreflang responde a esa pregunta. Cada página declara sus equivalentes y el buscador elige la que encaja con el usuario.

Conviene conocer tres límites desde el principio. Hreflang es una indicación, no una orden, así que un buscador todavía puede mostrar otra versión. No mejora la posición de una página: solo influye en cuál de sus versiones aparece para cada público. Y no traduce nada. Las versiones tienen que existir, y tienen que ser buenas.

Códigos hreflang válidos

Un valor es un código de idioma ISO 639-1, seguido opcionalmente de un código de región ISO 3166-1 alfa-2, unidos por un guion. Una región sola nunca es válida. El valor especial x-default señala la página de reserva.

Dos detalles hacen tropezar a mucha gente. El idioma va primero y la región después, de modo que es-MX es correcto y mx-es no lo es. Y la región debe ser un código de país ISO: el Reino Unido es GB, no UK.

Tres formas de implementar hreflang

Google documenta tres métodos equivalentes. Elija uno y aplíquelo en todas partes.

1. Etiquetas link en el head HTML

Es el método habitual para páginas web normales. Coloque una etiqueta por versión en el head de cada versión, incluida una que apunte a la propia página:

<link rel="alternate" hreflang="es-MX" href="https://example.com/es-mx/" />

Una página con tres versiones y una de reserva lleva cuatro etiquetas como esta, y las demás versiones llevan las mismas cuatro. Las etiquetas del head se revisan fácilmente en el código fuente, lo que las hace la mejor opción para sitios pequeños y medianos.

2. Cabecera HTTP para archivos que no son HTML

Un PDF no tiene head donde poner etiquetas. Para estos archivos, el servidor envía la anotación en la cabecera de la respuesta:

Link: <https://example.com/guia-es.pdf>; rel="alternate"; hreflang="es", <https://example.com/guia-en.pdf>; rel="alternate"; hreflang="en"

Se aplican las mismas reglas: liste todas las versiones, el propio archivo incluido. La configuración se hace en el servidor web o en el CDN. Compruebe las cabeceras con una herramienta como curl -I después de cada cambio.

3. Sitemap XML

En un sitio grande, el sitemap saca las anotaciones de las páginas y las reúne en un solo lugar. Declare el espacio de nombres xhtml en el elemento urlset y añada una línea como esta dentro de cada url:

<xhtml:link rel="alternate" hreflang="nl-BE" href="https://example.com/nl-be/" />

Cada entrada url enumera todas sus alternativas, ella misma incluida. El sitemap encaja en sitios con miles de páginas y varios idiomas, porque no aumenta el peso de las páginas. El precio es la visibilidad: no se ven las anotaciones al abrir una página.

Las reglas que importan

• Autorreferencia. Cada página se incluye a sí misma entre sus alternativas.
• Enlaces de retorno. Si la página A apunta a la página B, la B debe apuntar a la A. Sin enlace de retorno, la anotación puede ignorarse.
• URL absolutas. Use la dirección completa, con protocolo y host. Las rutas relativas no son válidas.
• Una URL por idioma y región. Dos páginas no pueden reclamar es-MX, y una misma URL no puede aparecer con dos valores.
• Destinos indexables. Cada URL debe responder 200, sin noindex y sin redirección.
• x-default. Indique una página de reserva para los visitantes que sus idiomas no cubren, normalmente un selector o la página global.

Hreflang y la etiqueta canonical

Las dos etiquetas responden a preguntas distintas. Canonical indica qué URL es la copia preferida de una página. Hreflang indica qué páginas son variantes de idioma y región entre sí.

Cada versión de idioma debe tener una canonical que apunte a sí misma. La página en francés lleva una etiqueta canonical hacia la URL francesa, y la inglesa hacia la URL inglesa. Si la página francesa declara como canonical la inglesa, usted le dice al buscador que la francesa es un duplicado que no debe indexarse, lo que anula la anotación hreflang que acaba de añadir. Las URL que figuran en hreflang deben ser las URL canónicas, y nada más.

Errores comunes de hreflang

Códigos no válidos

Los errores tipográficos en el valor son el fallo más frecuente y el más silencioso, porque nadie los avisa. Ejemplos: es-CE (esa región no existe), in-ID (in es un código en desuso, el indonesio es id), es-SP (España es ES), en-UK (use GB) y spanish (use es). Un buscador puede ignorar un valor que no sabe interpretar.

URL relativas

Una etiqueta con href="/es/" no es válida. La dirección necesita https:// y el host, siempre.

Enlaces de retorno que faltan

La página en inglés enumera la española, pero la española no enumera la inglesa. Ocurre cuando se añade un idioma a una plantilla y no a las demás, o cuando una página existe en dos idiomas pero no en un tercero.

Destinos que redirigen o bloquean la indexación

Una alternativa que devuelve un 301, un 404 o una etiqueta noindex no puede mostrarse en los resultados, así que la anotación no lleva a ninguna parte. Las redirecciones aparecen tras una migración, cuando URL antiguas se quedan en la plantilla.

Métodos mezclados que se contradicen

Algunos sitios declaran hreflang en el head y en el sitemap, con listas distintas. Cuando las dos fuentes discrepan, no se puede prever cuál seguirá el buscador. Elija un método, o genere ambos a partir de los mismos datos.

Cómo probar hreflang en su sitio en 10 minutos

• Minutos 1 y 2. Abra su página de inicio, vea el código fuente y busque hreflang. Anote cada valor.
• Minutos 3 y 4. Compare cada código con las listas ISO. Busque regiones solas, UK y códigos que no tengan dos letras.
• Minutos 5 y 6. Compruebe que cada href empieza por https:// e incluye su dominio.
• Minutos 7 y 8. Ejecute curl -sI en cada URL alternativa. Debe devolver 200, sin redirección ni noindex.
• Minuto 9. Abra una alternativa y confirme que enumera la primera página y a sí misma.
• Minuto 10. Compare la etiqueta canonical de cada versión con su propia URL.

Repita la prueba en una página profunda, como un producto o un artículo, porque las plantillas de esas páginas suelen diferir de la de inicio. Si usa un sitemap, ábralo y revise tres entradas del mismo modo.

Qué hacen 78 grandes sitios web

El 25 de octubre de 2026 leímos las páginas de inicio de grandes marcas y anotamos cómo declaran sus versiones de idioma. 78 páginas de inicio eran legibles. El método completo y sus límites están en el artículo de la auditoría.

• 45 de 78 (58 %) declaran hreflang para dos o más idiomas.
• 31 no declaran ninguno.
• De los 45, 31 (69 %) incluyen x-default y 14 (31 %) no.
• Un sitio publicó tres valores no válidos.
• Un sitio usaba URL relativas.
• 30 de 78 (38 %) redirigen el dominio raíz a una URL de idioma.

Las grandes marcas usan hreflang más a menudo que no, y los errores que quedan son los más básicos: una reserva ausente, códigos mal formados, rutas relativas. Ninguno exige herramientas avanzadas para corregirse. Basta con que alguien mire el código fuente.

En Globaprom construimos software con la internacionalización desde el principio: el enrutamiento por idioma, hreflang y los sitemaps se generan desde una única fuente de verdad. Si va a preparar algo así para su producto, empiece por la internacionalización de software explicada y nuestra página de software multilingüe.

Preguntas frecuentes