Una implementación correcta no traduce una web ni sustituye la estrategia internacional. Su función es declarar que varias URLs ofrecen versiones equivalentes por idioma o región.
Cuándo tiene sentido utilizar hreflang
Se utiliza cuando una misma página dispone de alternativas dirigidas a idiomas o mercados diferentes. Puede ser una traducción completa, una versión regional con precios y condiciones distintas o varias páginas en el mismo idioma adaptadas a países concretos.
No debe emplearse para relacionar contenidos diferentes solo porque tratan un tema parecido. Tampoco hace falta cuando la web tiene una única versión o cuando todas las personas reciben exactamente la misma URL y contenido.
Una categoría puede tener versiones para España, México y un mercado hispanohablante genérico. Hreflang ayuda a declarar la relación, pero cada URL debe conservar contenido, moneda, disponibilidad y canonical coherentes.
Códigos de idioma y región
El valor empieza por el idioma y puede añadir una región. Algunos ejemplos son es, es-ES, es-MX, en-GB o pt-BR. La región no puede utilizarse sola.
Para Reino Unido se usa GB, no UK. También existen combinaciones con escritura, como zh-Hans, cuando el caso lo requiere. Conviene mantener los códigos normalizados para facilitar su revisión.
Qué hace x-default
x-default señala una alternativa para usuarios cuyo idioma o región no coincide con las versiones definidas. Suele utilizarse en una página genérica o en un selector internacional. Es opcional y no necesita código de idioma.
Autorreferencia, conjunto completo y reciprocidad
Cada versión debe incluirse a sí misma y a todas las demás. Si existen versiones española, inglesa y predeterminada, las tres páginas deben publicar el mismo conjunto de tres anotaciones.
Los enlaces deben ser recíprocos. Si la página española declara la inglesa como alternativa, la inglesa debe apuntar de vuelta a la española. Cuando faltan enlaces de retorno, Google puede ignorar la relación.
- Utiliza URLs absolutas con protocolo y dominio.
- Incluye la propia URL en cada conjunto.
- Publica las mismas alternativas en todas las versiones.
- Comprueba que las páginas respondan correctamente.
- Mantén cada canonical dentro de su propia versión lingüística o regional.
Tres métodos equivalentes
Google admite etiquetas HTML en el <head>, cabeceras HTTP y anotaciones dentro de un sitemap XML. Los tres métodos son equivalentes para Google y no existe ventaja en mantener varios a la vez.
HTML
Es la opción más directa para páginas HTML y permite revisar el código en la plantilla. Cada página debe contener una etiqueta por alternativa.
<link rel="alternate" hreflang="es-ES" href="https://ejemplo.com/es/">
<link rel="alternate" hreflang="en-GB" href="https://ejemplo.com/en/">
<link rel="alternate" hreflang="x-default" href="https://ejemplo.com/">Sitemap XML
Puede ser más manejable cuando existe un gran número de páginas equivalentes y el sistema genera el archivo de forma automática. Cada elemento <url> debe listar todas las variantes, incluida la propia.
Cabeceras HTTP
Son útiles para documentos no HTML, como archivos PDF. Requieren control sobre la respuesta del servidor y suelen ser menos visibles durante una revisión manual.
Errores frecuentes
Los fallos no suelen estar en una etiqueta aislada, sino en la incoherencia del conjunto. Una nueva traducción, una redirección o un cambio de URL puede dejar relaciones incompletas.
- Códigos inventados o regiones incorrectas.
- URLs relativas en lugar de direcciones completas.
- Falta de autorreferencia.
- Páginas que no devuelven el enlace recíproco.
- Canónicas que apuntan a otro idioma.
- Alternativas redirigidas, bloqueadas o con
noindex. - Mezclar HTML, cabeceras y sitemap sin un proceso de mantenimiento.
Cómo revisar la implementación
- Prepara el mapa de URLs equivalentes antes de generar código.
- Valida formatos y duplicidades con el generador de hreflang.
- Publica el conjunto completo mediante un único método.
- Revisa el HTML renderizado o el sitemap publicado.
- Comprueba estados HTTP, canonicals, indexabilidad y enlaces de retorno.
- Vigila en Search Console qué URL aparece en cada mercado.
En proyectos internacionales grandes conviene generar y probar las relaciones desde la fuente de datos del ecommerce. Mantener manualmente miles de combinaciones termina provocando errores.
Genera el conjunto antes de publicarlo
Añade idiomas, regiones y URLs para obtener el bloque HTML y el fragmento de sitemap XML.
Abrir el generador hreflangFuentes y documentación
Javier Esteban del Río
Consultor SEO especializado en posicionamiento local, SEO técnico y ecommerce. Trabajo con negocios que necesitan convertir su visibilidad orgánica en contactos y ventas medibles.
Conocer experiencia y formación