Ver contenido
Introducción
El atributo hreflang le indica a Google qué versión de idioma o región de una página debe mostrar a cada usuario, evitando que versiones equivalentes en distintos idiomas compitan entre sí como si fueran contenido duplicado. El UXR SEO Analyzer valida la implementación de hreflang: sintaxis de códigos, presencia de enlaces de retorno y consistencia con la etiqueta canónica.
Esta guía cubre la sintaxis exacta, los tres métodos de implementación, el valor x-default, el requisito de enlaces bidireccionales y los errores que con más frecuencia hacen que Google ignore las anotaciones.
Sintaxis de Hreflang
Se declara en el <head> con una etiqueta <link> por cada versión de idioma/región, incluyendo una autorreferencia a la propia página:
<link rel="alternate" hreflang="es-CL" href="https://ejemplo.com/cl/" />
<link rel="alternate" hreflang="es-MX" href="https://ejemplo.com/mx/" />
<link rel="alternate" hreflang="en" href="https://ejemplo.com/en/" />
<link rel="alternate" hreflang="x-default" href="https://ejemplo.com/" />El código de idioma sigue ISO 639-1 (es, en, pt) y el código de región opcional ISO 3166-1 Alpha 2 (CL, MX, US), separados por un guion. El código de región es opcional pero el de idioma es obligatorio; nunca se debe usar solo un código de región sin idioma.
Tres Métodos de Implementación
| Método | Dónde Vive | Cuándo Usarlo |
|---|---|---|
Etiquetas <link> en el <head> | HTML de cada página | Sitios pequeños o medianos |
| Encabezado HTTP | Respuesta del servidor | Recursos no-HTML (PDF) |
| Sitemap XML | Archivo de sitemap | Sitios grandes—evita inflar el HTML de cada página |
Hreflang y Contenido Duplicado
Sin hreflang, dos páginas con contenido casi idéntico en el mismo idioma pero dirigidas a distintos países (por ejemplo, /us/ y /uk/ ambas en inglés) pueden competir entre sí en los resultados de búsqueda como si fueran contenido duplicado, diluyendo las señales de ranking entre ambas versiones. Hreflang resuelve esto explícitamente: le dice a Google que ambas páginas son variantes intencionales del mismo contenido para audiencias distintas, no un duplicado accidental, por lo que no se penalizan entre sí ni compiten por las mismas palabras clave.
Implementación en Sitemap XML para Sitios Grandes
Cuando un sitio tiene decenas de versiones de idioma/región, declarar hreflang en el <head> de cada página se vuelve inmanejable—una página con 10 versiones necesita 10 etiquetas <link> repetidas en cada una de las 10 páginas, es decir, 100 anotaciones sincronizadas. El sitemap XML centraliza esto en un solo archivo:
<url>
<loc>https://ejemplo.com/cl/</loc>
<xhtml:link rel="alternate" hreflang="es-MX" href="https://ejemplo.com/mx/" />
<xhtml:link rel="alternate" hreflang="en" href="https://ejemplo.com/en/" />
</url>Cada URL en el sitemap sigue necesitando referencias a todas sus alternativas, incluyendo una autorreferencia, pero el mantenimiento se centraliza en un único archivo generado programáticamente en lugar de en cientos de plantillas HTML.
El Valor x-default
El valor reservado x-default especifica la página de resguardo para usuarios cuya configuración de idioma o región no coincide con ninguna versión localizada del sitio—típicamente una página selectora de idioma o la versión global por defecto. Es recomendado, aunque no obligatorio, y se declara igual que cualquier otro valor hreflang.
El Requisito Más Importante: Enlaces de Retorno Bidireccionales
Google ha señalado explícitamente en su blog para desarrolladores que las anotaciones hreflang deben ser bidireccionales: si la página A enlaza a la página B como su versión en otro idioma, la página B debe enlazar de vuelta a la página A. Si falta cualquiera de las dos direcciones, Google ignora ambas anotaciones por completo—no solo la que falta. En sitios con múltiples idiomas, cada página necesita un enlace hacia cada una de las demás versiones, incluyendo una autorreferencia hacia sí misma.
Hreflang y URL Canónica
Cada versión localizada debe llevar su propia etiqueta canónica autorreferencial, apuntando a sí misma—nunca a la versión en otro idioma. Confundir estos dos mecanismos (por ejemplo, canonicalizar todas las versiones de idioma hacia la versión en inglés) le dice a Google que ignore las versiones "no canónicas", anulando el propósito de hreflang.
Cuándo Necesitas Hreflang (y Cuándo No)
No todo sitio con más de un idioma necesita hreflang. Si el sitio ofrece contenido completamente distinto por idioma sin páginas equivalentes entre versiones, hreflang no aporta nada porque no hay contenido "alternativo" que anotar. Hreflang se vuelve necesario cuando existen dos o más páginas que son esencialmente la misma pieza de contenido, adaptada a un idioma o región distinta—la situación exacta donde, sin la anotación, Google podría tratarlas como competidoras o como duplicados.
| Escenario | ¿Necesita Hreflang? |
|---|---|
| Mismo artículo traducido a 3 idiomas | Sí |
| Tienda con catálogo de productos distinto por país | Solo en las páginas equivalentes (categoría, home) |
| Blog corporativo solo en un idioma | No |
| Misma página en inglés para EE.UU. y Reino Unido con precios distintos | Sí (es-US vs en-GB) |
Errores Comunes
- Enlaces de retorno faltantes: la causa más frecuente de que Google ignore las anotaciones
- Códigos de idioma incorrectos: usar códigos inventados o mal formados en lugar de ISO 639-1/3166-1
- Falta de autorreferencia: una página debe incluirse a sí misma en su propio conjunto de anotaciones hreflang
- Conflicto con canonical: canonicalizar hacia una versión de idioma distinta
- URLs que no resuelven con 200: enlazar a versiones que redirigen o devuelven error
- Confundir código de idioma con código de país: usar
CLcomo si fuera un código de idioma en vez de región
Consistencia Entre Métodos de Implementación
Un sitio no debería mezclar los tres métodos de implementación (etiquetas <link>, encabezado HTTP y sitemap) para las mismas URLs, ya que valores contradictorios entre métodos generan el mismo problema que enlaces de retorno faltantes: Google puede optar por ignorar el conjunto completo de anotaciones para esa URL. Si el sitio ya declara hreflang en el sitemap, no es necesario repetirlo en el <head> de cada página—elegir un único método y mantenerlo consistente reduce la superficie de error.
Cómo Diagnosticar Problemas de Hreflang
El Informe de Segmentación Internacional de Search Console muestra errores de hreflang detectados a nivel de sitio, incluyendo enlaces de retorno faltantes y códigos de idioma no válidos. A nivel de página, verificar manualmente que cada URL en el conjunto de anotaciones cargue con código 200 y que su propio conjunto hreflang incluya un enlace de vuelta es la forma más confiable de detectar rupturas en la cadena bidireccional.
Relación con la Estructura de URL
Hreflang no reemplaza una buena estructura de URL internacional—la complementa. Ya sea que un sitio use subdirectorios (/es/, /en/), subdominios (es.ejemplo.com) o ccTLDs (ejemplo.es, ejemplo.de), hreflang sigue siendo necesario para conectar explícitamente las versiones equivalentes entre sí. La elección de estructura de URL afecta la facilidad de implementación (los subdirectorios suelen ser más simples de mantener que múltiples dominios) pero no elimina la necesidad de anotaciones hreflang correctas.
Qué Revisa el UXR SEO Analyzer
La herramienta valida el formato de los códigos de idioma/región, confirma que exista una autorreferencia, detecta cuándo las anotaciones hreflang entran en conflicto con la etiqueta canónica de la página, y señala cuándo una URL referenciada en hreflang no devuelve una respuesta exitosa.
Referencias
- Google Search Central - Versiones Localizadas de tus Páginas
- Google Search Central Blog - Solucionando Problemas de Anotaciones Hreflang
- Google Search Central Blog - x-default Hreflang para Páginas Internacionales
- Google Search Central Blog - Unificando Contenido en Plantillas Multilingües