Guía completa de hreflang: implementación, códigos y resolución de problemas

Hreflang es una de las señales más importantes del SEO internacional y una de las que más fallan. Los equipos añaden anotaciones con la esperanza de que Google «dirija a los usuarios al idioma correcto», pero meses después descubren que faltan enlaces de retorno, que los códigos de región no son válidos o que las etiquetas canónicas contradicen la agrupación de URL.

Esta guía es una referencia práctica de implementación. Explica qué hace hreflang (y qué no), cuándo lo necesitas, los tres métodos admitidos, las reglas de agrupación que realmente importan, cómo funcionan los códigos y x-default, cómo coordinar hreflang con las etiquetas canónicas y cómo depurar los errores que hacen que se ignoren las anotaciones. Las afirmaciones se basan en la documentación de Google, sin promesas de posicionamiento.

Preguntas que responde esta guía

• ¿Qué es hreflang y qué problema resuelve?
• ¿Cuándo debería un sitio implementar hreflang?
• ¿Cuáles son los tres métodos de implementación admitidos y cómo deberían los equipos elegir entre ellos?
• ¿Qué reglas debe cumplir cada agrupación hreflang?
• ¿Cómo funcionan los códigos de idioma y región, incluido x-default?
• ¿Cómo debe funcionar hreflang junto con las etiquetas canónicas?
• ¿Cuáles son los errores más comunes de hreflang y cómo se depuran?
• ¿Hreflang detecta el idioma de una página o sustituye la traducción?

Respuesta rápida: qué hace hreflang

Hreflang informa a Google de las variantes de una página por idioma o región para que su buscador pueda dirigir a los usuarios a la versión más adecuada. Se recomienda indicarlas explícitamente, aunque Google puede encontrar algunas versiones en otros idiomas sin anotaciones.

Hreflang no sirve para:

• detectar el idioma de una página (Google utiliza algoritmos que analizan el contenido visible, no hreflang ni el atributo lang de HTML)
• sustituir el trabajo de traducción o localización
• garantizar el posicionamiento en ningún país o idioma

Considéralo un mapa de relaciones entre URL alternativas, no un detector de idiomas ni una herramienta para mejorar el posicionamiento.

Cuándo necesitas hreflang

Google recomienda usar anotaciones de páginas alternativas en situaciones como las siguientes:

• traducción únicamente de la plantilla, mientras el contenido principal permanece en un solo idioma
• pequeñas variaciones regionales de un mismo idioma (por ejemplo, la moneda, los datos de contacto o los textos legales)
• contenido multilingüe completamente traducido

Las versiones localizadas solo se consideran duplicadas cuando el contenido principal permanece sin traducir. Esta distinción es importante: una página con pequeñas adaptaciones para un país, en el mismo idioma, puede seguir siendo una alternativa válida; una «traducción» superficial limitada a los elementos de la interfaz no debe considerarse una versión completa en otro idioma.

Por lo general, necesitas hreflang cuando los usuarios de distintos idiomas o países deben llegar a diferentes URL rastreables que responden a la misma intención. Puede que no lo necesites para un sitio con un solo idioma dirigido a un único mercado, o si decides publicar una única URL global y ofrecer la misma experiencia a todo el mundo.

Los nombres de las carpetas y las etiquetas de los subdominios (/de/, de.example.com) no bastan por sí solos. Google no utiliza esos códigos de las rutas o los subdominios para determinar el público objetivo, a menos que lo indiques explícitamente; hreflang es la forma habitual de hacerlo.

Reglas básicas del grupo

Toda configuración correcta de hreflang forma un grupo: un conjunto de URL que se declaran mutuamente como alternativas. Las reglas de Google son lo bastante estrictas como para que los grupos incompletos a menudo fallen sin dar señales de error.

Si resulta difícil mantener un conjunto completo de referencias bidireccionales a gran escala, Google sigue procesando los pares que se referencian mutuamente, pero los nuevos idiomas deben vincularse de forma bidireccional con el idioma o los idiomas originales o predominantes. No consideres la «reciprocidad parcial» una estrategia a largo plazo, sino un riesgo durante la migración.

Códigos de idioma y región

Los valores de hreflang utilizan códigos de idioma ISO 639-1, que pueden combinarse con códigos de región ISO 3166-1 Alpha 2.

Patrones no válidos o ineficaces que conviene evitar:

• usar solo la región (US) — no es válido
• tratar EU, UN o UK como códigos de región que influyen en la Búsqueda de Google — no lo hacen
• formatos no admitidos, como es-419

Cuando varias URL regionales comparten un idioma (por ejemplo, en-IE, en-CA, en-AU), proporciona también una versión genérica para ese idioma, como en, destinada a los usuarios cuya ubicación geográfica no esté especificada.

Utiliza x-default como opción de reserva cuando no haya coincidencias con ningún otro idioma o región, especialmente en selectores de idioma o páginas de inicio con redirección automática. x-default no significa «inglés», sino «no hay una coincidencia mejor».

Método de implementación 1: etiquetas de enlace HTML

Coloca las etiquetas de enlace a versiones alternativas en un <head> bien formado. No combines hreflang con otros atributos de representación alternativa, como media, en la misma etiqueta de enlace.

Ejemplo para un grupo pequeño (en-US, en-GB, fr, x-default):

<link rel="alternate" hreflang="en-US" href="https://example.com/en-us/pricing" />
<link rel="alternate" hreflang="en-GB" href="https://example.com/en-gb/pricing" />
<link rel="alternate" hreflang="fr" href="https://example.com/fr/pricing" />
<link rel="alternate" hreflang="x-default" href="https://example.com/pricing" />

Cada página del grupo necesita el mismo conjunto de anotaciones (incluida su propia URL). Generar las etiquetas a partir de una matriz compartida de idiomas y regiones en tu CMS o generador de sitios estáticos es más seguro que editar las páginas manualmente.

Método de implementación 2: cabeceras HTTP

Para archivos que no sean HTML, o cuando tu infraestructura de borde/CDN favorezca la inyección de cabeceras, Google admite la cabecera HTTP Link con la misma semántica:

Link: <https://example.com/en-us/pricing>; rel="alternate"; hreflang="en-US",
      <https://example.com/en-gb/pricing>; rel="alternate"; hreflang="en-GB",
      <https://example.com/fr/pricing>; rel="alternate"; hreflang="fr",
      <https://example.com/pricing>; rel="alternate"; hreflang="x-default"

Las cabeceras son útiles cuando resulta complicado inyectar <head> en el HTML, pero son más difíciles de revisar para los equipos de contenido. Si utilizas cabeceras, documenta el servicio que las genera e incluye su comprobación en los controles de calidad.

Método de implementación 3: sitemaps XML

Los sitemaps permiten declarar versiones alternativas por idioma o configuración regional mediante entradas xhtml:link. Cada entrada de URL debe enumerar todas las versiones alternativas, incluida ella misma.

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
        xmlns:xhtml="http://www.w3.org/1999/xhtml">
  <url>
    <loc>https://example.com/en-us/pricing</loc>
    <xhtml:link rel="alternate" hreflang="en-US" href="https://example.com/en-us/pricing"/>
    <xhtml:link rel="alternate" hreflang="en-GB" href="https://example.com/en-gb/pricing"/>
    <xhtml:link rel="alternate" hreflang="fr" href="https://example.com/fr/pricing"/>
    <xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/pricing"/>
  </url>
  <!-- Repeat a <url> block for each alternate, each listing the full set -->
</urlset>

La generación de sitemaps se adapta bien a los catálogos grandes, pero solo si el flujo de procesamiento vuelve a generar el conjunto completo de referencias recíprocas cada vez que se añade o elimina una configuración regional.

Cómo elegir un método

Para Google, las etiquetas HTML, las cabeceras HTTP y los sitemaps son equivalentes. Utilizar los tres a la vez no mejora los resultados en la Búsqueda; multiplica el riesgo de inconsistencias.

Elige una única fuente de referencia. Muchos equipos de ingeniería prefieren los sitemaps para trabajar a gran escala y el HTML para sitios de marketing con pocas versiones regionales. Ambas opciones son válidas si se mantiene la reciprocidad correcta.

Hreflang y etiquetas canónicas

Hreflang y las etiquetas canónicas resuelven problemas distintos. Hreflang relaciona versiones alternativas por idioma o región. Las etiquetas canónicas indican la URL preferida entre páginas casi duplicadas.

Reglas para mantener la coherencia entre ambas:

1. Al usar hreflang, especifica una página canónica en el mismo idioma o, si no existe, en el idioma alternativo más adecuado.
2. No sobrecargues un único enlace rel="canonical" con los atributos hreflang, lang, media o type: esas anotaciones combinadas no se utilizan para la canonicalización. Mantén separadas las anotaciones de versiones alternativas.
3. Para la canonicalización, Google prefiere las URL que forman parte de grupos hreflang con enlaces recíprocos frente a otras URL similares que quedan fuera del grupo.
4. Para contenido similar o duplicado en el mismo idioma y en URL de distintas regiones, elige una versión preferida y utiliza rel="canonical" junto con hreflang.

Patrón práctico para páginas de distintos países en el mismo idioma: cada URL de país puede ser una versión alternativa hreflang (en-US, en-CA), mientras que la etiqueta canónica de cada página apunta a sí misma (o a una URL preferida elegida expresamente si realmente quieres consolidarlas). No hagas que las etiquetas canónicas de todos los países apunten a una única URL global en inglés si, al mismo tiempo, esperas que la URL de cada país siga siendo la versión alternativa que se muestra: esas señales se contradicen.

Ejemplo práctico: grupo por idioma y región

Imagina una página de precios con estas versiones:

• Inglés de Estados Unidos: https://example.com/en-us/pricing → en-US
• Inglés del Reino Unido: https://example.com/en-gb/pricing → en-GB
• Francés global: https://example.com/fr/pricing → fr
• Selector de idioma / versión de respaldo: https://example.com/pricing → x-default
• Versión genérica en inglés opcional: https://example.com/en/pricing → en (recomendada cuando existen variantes regionales del inglés)

En cada una de las URL anteriores, incluye el conjunto completo de enlaces recíprocos. En la página de Estados Unidos, el HTML incluiría una referencia a sí misma, además de GB, FR, x-default y la versión genérica en inglés, si publicas una.

Consejo de gestión: almacena la matriz como datos (locale → url), genera las anotaciones a partir de ella y haz que la integración continua falle si falta un enlace de retorno en alguna versión regional. La edición manual de etiquetas deja de ser viable al lanzar un tercer idioma.

Errores comunes y depuración

Google señala expresamente varios errores comunes: la falta de enlaces de retorno y los códigos de idioma o de región incorrectos. En la práctica, la mayoría de los fallos en producción encajan en alguno de estos casos:

Pasos para depurar:

1. Exporta la matriz prevista de configuraciones regionales × URL.
2. Para una URL de muestra, obtén el HTML renderizado, las cabeceras o las entradas del sitemap y enumera todos los destinos de hreflang.
3. Confirma que la página se incluye a sí misma.
4. Confirma que cada destino devuelve el mismo conjunto (o al menos un par de enlaces recíprocos durante la migración).
5. Valida los códigos con las listas ISO; rechaza UK/EU/UN como códigos de región.
6. Confirma que el idioma de la URL canónica coincide con el de la página.
7. Vuelve a comprobarlo tras el lanzamiento de la siguiente configuración regional, no solo en la publicación inicial.

Los validadores de terceros pueden ayudar, pero Google no se encarga de su mantenimiento. Da prioridad a la documentación de Google y a tus propias pruebas de reciprocidad frente al visto bueno de una sola herramienta.

Lista de comprobación para la implementación

• Confirma que necesitas versiones alternativas (URL para varios idiomas o regiones)
• Crea una matriz de configuraciones regionales × URL antes de escribir las etiquetas
• Elige un solo método de implementación (HTML, cabeceras o sitemaps)
• Usa únicamente URL absolutas
• Incluye autorreferencias en todas las páginas
• Garantiza la reciprocidad (enlaces de retorno)
• Usa códigos válidos de idioma y de idioma-región; añade códigos de sistema de escritura solo cuando sea necesario
• Añade versiones genéricas por idioma cuando existan variantes regionales de un mismo idioma
• Configura x-default para los selectores y las versiones alternativas cuando no haya coincidencias
• Alinea las URL canónicas con la preferencia por versiones del mismo idioma
• Mantén canonical y hreflang como anotaciones independientes
• Comprueba una muestra de URL cada vez que añadas o elimines una configuración regional
• Ofrece enlaces de idioma y región visibles para los usuarios (no dependas solo de las anotaciones para la experiencia de usuario)

Hreflang y los motores de respuesta con IA

Hreflang es una anotación de Google Search (también relevante para otros buscadores que tienen en cuenta las señales de páginas alternativas). Indica a los rastreadores cómo se relacionan las versiones de idioma y región. No garantiza que ChatGPT, Claude, Gemini, Perplexity, Copilot o las AI Overviews de Google elijan la versión de idioma «correcta» en una respuesta.

Lo que sí sigue ayudando a los motores de respuesta es que cada versión de idioma sea rastreable e indexable, tenga el contenido principal completamente localizado y mantenga la coherencia al referirse a una misma entidad. Estas cualidades facilitan el descubrimiento y la selección de fuentes, incluso cuando un asistente ignora hreflang. No apliques los pasos de diagnóstico de hreflang de Google como si fueran controles universales de posicionamiento en sistemas de IA.

Las guías específicas de SEO multilingüe para Google y Bing siguen siendo la referencia para profundizar en la implementación en cada buscador.

Optimización para Google Search (hreflang)

Google Search es el principal buscador que utiliza las anotaciones hreflang. Implementa grupos de páginas con enlaces recíprocos, códigos válidos y URL canónicas alineadas siguiendo exactamente la documentación de Google. Diagnostica los problemas con los informes internacionales de Search Console cuando estén disponibles.

Optimización para Bing (páginas alternativas)

Bing puede interpretar las señales de páginas alternativas de forma distinta a Google. Mantén rastreables las URL de cada configuración regional y comprueba la cobertura en Bing Webmaster Tools, en lugar de dar por hecho que el comportamiento de los grupos hreflang de Google se aplica de forma idéntica.

Guía de plataforma: ChatGPT

Hreflang no obliga a ChatGPT a elegir una versión de idioma. Lo que ayuda es contar con una URL rastreable y completamente localizada que pueda citarse o utilizarse como fuente cuando la respuesta se fundamente en fuentes externas. No des por segura la selección de idioma en las respuestas.

Guía de plataforma: Gemini

Las versiones de idioma indexables siguen siendo útiles para Gemini y las experiencias de IA de Google. No consideres hreflang un selector de idioma para las AI Overviews: mantén páginas localizadas, pensadas ante todo para las personas y que Google pueda rastrear.

Guía de plataforma: Google AI Overviews

Las AI Overviews pueden enlazar a páginas que respalden sus respuestas. Hreflang por sí solo no determina el idioma del resumen. En la práctica, contar con páginas localizadas e indexables sigue siendo un requisito previo; su inclusión no está garantizada.

Dónde encaja GlotEO

Implementar hreflang correctamente es una cuestión de ingeniería y operaciones de contenido: a medida que se amplían los mercados, la matriz debe mantenerse alineada con la investigación, las directrices de contenido y las versiones de idioma publicadas. La plataforma de SEO multilingüe de GlotEO puede facilitar ese flujo de trabajo editorial en proyectos multilingües, sin sustituir las reglas de anotación anteriores.

Los equipos que necesitan control editorial en distintas configuraciones regionales pueden utilizar la solución de SEO multilingüe de GlotEO y, después, comparar los precios y planes de GlotEO.

Para conocer el contexto estratégico de la segmentación por idioma frente a la segmentación por país, consulta SEO internacional frente a SEO multilingüe. La arquitectura de URL y las decisiones sobre traducción frente a localización deben mantenerse alineadas con las reglas de anotación anteriores.