Guía de Hreflang: Sintaxis, Errores y Buenas Prácticas

Hreflang (también conocido como atributo rel="alternate" hreflang="x") es una etiqueta HTML que comunica a los motores de búsqueda qué versión de idioma y región geográfica debe mostrarse a cada usuario en los resultados de búsqueda.

Sin etiquetas hreflang, Google recurre a algoritmos de detección automática de idioma para determinar qué página mostrar. Esto provoca habitualmente que la versión incorrecta aparezca en mercados internacionales, generando altas tasas de rebote y perjudicando el posicionamiento general del sitio web.

Con un etiquetado hreflang preciso, Google empareja cada consulta con la versión idónea: un usuario en México ve la página en español mexicano, mientras que un usuario en el Reino Unido recibe la versión en inglés británico. Además, elimina el riesgo de penalizaciones por contenido duplicado entre variantes lingüísticas similares.

Hreflang utiliza el atributo link rel="alternate" con un valor hreflang. El valor combina un código de idioma ISO 639-1 con un código de región ISO 3166-1 alpha-2 opcional. Ejemplos: en (inglés, cualquier región), en-US (inglés de Estados Unidos), zh-CN (chino simplificado, China continental), zh-TW (chino tradicional, Taiwán), es-MX (español de México), fil-PH (filipino de Filipinas).

Fundamental: los códigos de región distinguen entre mayúsculas y minúsculas. zh-CN es correcto; zh-cn o zh-cN no lo son. Google ignora silenciosamente las mayúsculas y minúsculas incorrectas. Utiliza siempre subetiquetas de región en mayúsculas según la norma ISO.

Una implementación completa de hreflang requiere tres elementos en cada página: (1) una etiqueta hreflang autorreferencial (la página declara su propio locale), (2) una etiqueta hreflang para cada una de las demás versiones de locale (las alternativas), y (3) una etiqueta x-default que apunte al locale a mostrar cuando ninguna alternativa coincida con el usuario. Omitir cualquiera de ellas invalida la implementación.

Cada alternativa debe ser bidireccional. Si la página A (inglés) declara a la página B (chino) como su alternativa, la página B debe declarar a la página A como su alternativa. La falta de etiquetas de retorno es el error de hreflang más común: Google ignora ambas direcciones cuando falta una.

Error 1 — Mayúsculas incorrectas en los códigos de locale. Escribir zh-cn en lugar de zh-CN, o fil-ph en lugar de fil-PH. Google ignora en silencio las etiquetas mal formateadas. Solución: pon siempre en mayúsculas las subetiquetas de región.

Error 2 — Etiquetas de retorno ausentes. La página A declara a la página B como alternativa, pero la página B no declara a la página A. Solución: cada alternativa debe ser bidireccional; si añades un nuevo locale, actualiza todas las páginas existentes para declararlo de vuelta.

Error 3 — Falta o asignación errónea de x-default. Sin x-default, Google deduce qué locale mostrar a los usuarios sin coincidencia; normalmente elige tu locale más indexado, que puede no ser el deseado. Solución: declara explícitamente x-default (apuntando normalmente al locale principal de tu negocio).

Error 4 — URLs de hreflang que no coinciden con las URLs canónicas. Si /pricing tiene como canonical /pricing, pero su hreflang apunta a /pricing?utm_source=internal, Google descarta la alternativa. Solución: las URLs de hreflang deben coincidir carácter por carácter con las URLs canónicas.

Error 5 — Hreflang en páginas con noindex o canonicalizadas hacia otra URL. Las páginas bloqueadas de la indexación no deben declarar hreflang. Solución: omite las etiquetas hreflang en rutas noindex, rutas redirigidas y páginas canonicalizadas hacia otras URLs.

Error 6 — Hreflang hacia páginas con soft-404 o «idioma no disponible». No declares una URL alternativa que devuelva un mensaje de «lo sentimos, esta página no está disponible en su idioma»; eso constituye un soft 404 y Google penaliza ambas direcciones. Solución: declara únicamente alternativas con contenido real; si una página no existe en un locale, no declares ese locale como alternativa.

Error 7 — Variantes de locale incoherentes entre páginas. La página A declara los locales en, zh-CN, es, pero la página B solo declara en y zh-CN. La inconsistencia confunde a Google. Solución: cada página que exista en múltiples locales debe declarar todos los locales donde existe, y ningún locale donde no exista.

Paso 1 — Inspecciona el código fuente HTML renderizado. Abre el código fuente en cualquier página multilingüe y confirma la presencia de la etiqueta autorreferencial, las alternativas de cada idioma y la etiqueta x-default.

Paso 2 — Comprueba Google Search Console. En el informe de segmentación internacional, Google detalla los errores de correspondencia o sintaxis detectados en el rastreo. Corrige cualquier incidencia notificada.

Paso 3 — Ejecuta un rastreo con herramientas como Ahrefs o Sitebulb. Estas plataformas permiten auditar la integridad bidireccional de miles de páginas simultáneamente, detectando enlaces rotos o códigos erróneos.

Paso 4 — Realiza pruebas directas en buscadores mediante conexiones VPN o dominios regionales de Google para verificar qué versión idiomática se presenta en cada territorio geográfico.

Paso 5 — Utiliza la herramienta de inspección de URLs en Search Console para verificar que cada variante idiomática ha sido indexada satisfactoriamente con sus asociaciones reconocidas.

Recomendación 1 — Utiliza códigos solo de idioma (como es o en) cuando tu contenido no difiera entre países. Limita los códigos regionales (como es-ES o es-MX) a casos donde existan diferencias reales de precios, legislación o vocabulario.

Recomendación 2 — Establece x-default hacia el idioma troncal de tu negocio. Esto garantiza una experiencia predecible para visitantes internacionales de mercados secundarios.

Recomendación 3 — Centraliza la generación de hreflang en tu plataforma o CMS en lugar de redactar etiquetas manualmente, eliminando discrepancias por modificaciones futuras de páginas.

Recomendación 4 — Mantén las URLs limpias y estables. Evita parámetros de consulta o identificadores de sesión en las direcciones declaradas en hreflang.

Recomendación 5 — Audita periódicamente las etiquetas tras cada publicación o eliminación de idiomas en el sitio web.

Cogo Site genera todas las etiquetas hreflang desde una única fuente de verdad basada en el enrutamiento de URLs con prefijos de idioma. Cada página publicada incorpora automáticamente etiquetas autorreferenciales, alternativas y x-default con formato ISO exacto y correspondencia canónica total.

La adición o eliminación de un idioma regenera atómicamente las etiquetas en todo el sitio web, asegurando que no queden enlaces rotos ni referencias huérfanas hacia versiones inexistentes.

El control de visibilidad por página permite publicar contenidos exclusivos de un idioma sin emitir referencias erróneas hacia páginas no traducidas, previniendo penalizaciones por páginas vacías.

La versión x-default es totalmente configurable y las direcciones emitidas provienen del mismo árbol canónico del sitio, garantizando sincronía permanente.