Comprobador de hreflang: cómo validar las etiquetas hreflang y arreglar los errores
Hreflang indica a los buscadores qué versión de idioma o región de una página mostrar a quién. La idea es sencilla. La implementación es frágil: cada página tiene que enumerar todas las versiones, cada versión tiene que devolver el enlace, y un código erróneo o una URL que redirige pueden hacer poco fiable todo un conjunto. Un comprobador de hreflang lo lee todo a la vez.
Qué hace un comprobador de hreflang
Las etiquetas hreflang de una sola página dicen muy poco. Los errores que importan solo aparecen al comparar páginas entre sí: la página A enumera la página B, pero ¿la página B enumera la A? ¿B responde 200? ¿B es su propio canonical? Por eso un validador de hreflang para una URL sirve para comprobaciones puntuales, mientras que un crawler es el comprobador de hreflang para todo un sitio.
Una revisión completa lee las etiquetas de cada página, sigue cada destino y responde a cuatro preguntas para cada conjunto:
- ¿Todos los códigos son válidos?
- ¿Cada página se enumera a sí misma y a todas las demás versiones?
- ¿Cada destino devuelve el enlace?
- ¿Cada destino es una URL indexable, canonical de sí misma, que responde 200?
Cómo funcionan las etiquetas hreflang
La guía de Google sobre las versiones localizadas de tus páginas describe tres formas de declarar hreflang. Elige una por conjunto.
| Método | Páginas HTML | PDF y archivos | Se ubica en |
|---|---|---|---|
| Etiquetas link | ✓ | – | Head del HTML |
| Cabecera HTTP Link | ✓ | ✓ | Respuesta del servidor |
| Sitemap XML | ✓ | ✓ | Archivo del sitemap |
1. Etiquetas link en el head del HTML
<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="de" href="https://example.com/de/preise/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/pricing/" />
Las mismas cuatro líneas van en las cuatro páginas, incluida la de x-default.
2. La cabecera HTTP Link
Útil para PDF y otros archivos que no tienen head HTML:
Link: <https://example.com/en/guide.pdf>; rel="alternate"; hreflang="en",
<https://example.com/de/guide.pdf>; rel="alternate"; hreflang="de"
3. El sitemap XML
<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="de" href="https://example.com/de/preise/" />
</url>
El sitemap necesita el namespace xhtml declarado en su elemento urlset, y cada entrada url repite el conjunto completo. Los sitemaps sacan los conjuntos grandes del head de la página, pero es fácil olvidarlos cuando las páginas cambian.
Las reglas que debe cumplir todo conjunto de hreflang
- Autorreferencia. Google dice que cada versión debe enumerarse a sí misma además de a todas las demás versiones.
- Enlaces de retorno. Si la página A apunta a la página B, B debe apuntar de vuelta a A. Google dice que si dos páginas no apuntan la una a la otra, las etiquetas se pueden ignorar.
- URL absolutas. https://example.com/de/, no /de/.
- Destinos sanos. Cada destino debería responder 200, ser indexable y ser su propio canonical. Una etiqueta que apunta a una redirección, a un 404 o a una página noindex es una señal que los buscadores tienen que sortear.
- La página equivalente. La página de precios en alemán debería apuntar a la página de precios en francés, no a la página de inicio en francés.
Los códigos siguen estándares fijos. Google los enumera en su guía de versiones localizadas:
| Código | Standard | Ejemplo | Válido |
|---|---|---|---|
| Idioma | ISO 639-1 | de, pt | ✓ |
| Idioma y región | ISO 3166-1 Alpha 2 | de-at, pt-br | ✓ |
| Idioma y escritura | ISO 15924 | zh-Hant | ✓ |
| Solo región | ninguno | us | – |
| Reino Unido | GB, no UK | en-uk | – |
| Alternativa por defecto | Valor reservado | x-default | ✓ |
x-default: la versión por defecto
x-default es un valor reservado para la página que se muestra cuando ningún otro idioma o región del conjunto coincide con el visitante. Google lo sugiere para las páginas de selección de idioma y para las páginas que redirigen a los visitantes según su idioma o ubicación.
<link rel="alternate" hreflang="x-default" href="https://example.com/" />
Es opcional, pero conviene en la página de inicio y en cualquier página con un selector de idioma. Como cualquier otro destino, la URL de x-default debería responder 200, ser indexable y ser su propio canonical, y todas las páginas del conjunto deberían indicar el mismo x-default. Un fallo habitual es apuntar x-default a una URL que redirige a los visitantes por ubicación y dejar que esa redirección acabe en un error.
Los errores de hreflang más habituales
| Error | Cómo se ve | Corrección |
|---|---|---|
| Sin enlace de retorno | de omite en-us | Una lista común por conjunto |
| Sin autorreferencia | La página se omite a sí misma | Añade su propia URL |
| Código de región erróneo | en-uk | en-gb |
| Región sin idioma | hreflang="us" | en-us |
| URL relativa | /de/ | URL https completa |
| El destino redirige o da error | La URL francesa hace 301 | URL final |
| El destino tiene canonical a otra URL | URL con parámetros | URL canonical |
| Un código, dos URL | Dos páginas marcadas como de | Una URL por código |
| Etiquetas fuera del head | Un script cierra el head antes de tiempo | Súbelas, o usa la cabecera |
| Idioma que no coincide | hreflang fr, html lang en | Haz que coincida con el texto de la página |
La guía de implementación de hreflang y SEO internacional de SEO ProCheck repasa cada uno con más detalle.
Hreflang y canonicals
Las etiquetas hreflang y canonical funcionan juntas, y se estropean entre sí con facilidad. Cada versión de idioma debería ser su propio canonical. Si la página en alemán indica la página en inglés como canonical, les estás diciendo a los buscadores que la alemana es un duplicado, lo que va en contra de su hreflang. Un canonical apunta dentro de un idioma; hreflang apunta entre idiomas.
Comprueba también que cada URL de un conjunto de hreflang es la versión canonical: mismo protocolo, mismo host, misma barra final. Un conjunto que mezcla URL http y https, o URL con y sin barra, no supera la comprobación de enlaces de retorno aunque las páginas estén bien, porque las URL no coinciden exactamente.
Cómo revisar el hreflang de todo un sitio
- Rastrea todas las versiones de idioma. Si cada idioma está en su propio dominio o subdominio, inclúyelos todos en el rastreo, o no se podrán comprobar los enlaces de retorno.
- Lee hreflang en todos los métodos que uses: el head del HTML, la cabecera HTTP Link y los sitemaps. Un conjunto declarado de dos formas es un conjunto que puede contradecirse.
- Valida los códigos antes que nada. Un código erróneo repetido por una plantilla puede afectar a miles de páginas.
- Comprueba los enlaces de retorno y las autorreferencias de cada página.
- Comprueba la salud de los destinos: estado, indexabilidad y canonical de cada destino.
- Busca conjuntos que faltan: páginas con equivalentes en otros idiomas pero sin ningún hreflang.
- Arregla en la plantilla o en el plugin, no página por página, y vuelve a rastrear.
Lo hacemos en nuestro propio sitio. neova.app funciona en 15 idiomas. En nuestra revisión SEO del 20 de noviembre de 2026, sus sitemaps XML incluían 1.358 URL, y todos los enlaces hreflang tenían retorno: totalmente recíprocos. Con 15 versiones, cada página enumera 15 URL, ella incluida, y cada una de ellas debe devolverle el enlace. Genera todas las etiquetas de un conjunto a partir de una lista común, y los enlaces de retorno vendrán solos.
Los conjuntos de hreflang son el paso 12 de la checklist de auditoría SEO técnica. Si tus versiones de idioma redirigen a los visitantes, lee también la guía de cadenas de redirecciones.
Revisa el hreflang con Neova
La categoría Internacional de Neova muestra las versiones de idioma y región de cada página y si apuntan unas a otras. Lee hreflang del head del HTML y de la cabecera HTTP Link, añade las columnas Idiomas hreflang y Destinos hreflang a cada página HTML, y compara html lang con hreflang y con el propio texto de la página. Algunas de las comprobaciones:
- Falta el enlace de retorno de hreflang y Falta la autorreferencia de hreflang
- Código de idioma de hreflang no válido y Código de país de hreflang no válido
- Hreflang apunta a una URL que no devuelve 200 y Hreflang apunta a una URL canonicalizada
- El destino comodín de hreflang está roto, tiene noindex, está canonicalizado o es incoherente
- Hreflang apunta a la raíz de un idioma, no a la URL equivalente
- Hreflang y el lang del HTML no coinciden en el idioma
- Falta hreflang donde existen equivalentes en otros idiomas
Cada aviso explica por qué importa, cómo arreglarlo y su fuente, y cada tabla se exporta a CSV o Excel para el desarrollador que arregle la plantilla. Neova ejecuta las 694 comprobaciones en todos los planes, Free incluido:
| Neova | |
|---|---|
| Funciona en | |
| Comprobaciones | 694 |
| Plan gratuito | 1.000 URL por rastreo |
| Idiomas de interfaz | 15 |
Mac significa Apple silicon; en el navegador es Neova Online, con la misma cuenta. Consulta las Funciones, los Precios o descarga Neova.
Preguntas
¿Qué es un comprobador de hreflang?
Una herramienta que lee las etiquetas hreflang de un sitio y las contrasta entre sí: códigos de idioma y región válidos, autorreferencias, enlaces de retorno, x-default, y si cada destino responde 200, es indexable y es su propio canonical.
¿Qué son los enlaces de retorno de hreflang?
Si la página A enumera la página B como alternativa, la página B también debe enumerar la A. Google dice que, cuando dos páginas no apuntan la una a la otra, sus etiquetas hreflang se pueden ignorar.
¿Es obligatorio x-default?
No, es opcional. Se recomienda en las páginas de selección de idioma, en las páginas de inicio y en las páginas que redirigen a los visitantes por idioma o ubicación, para que los buscadores sepan qué versión mostrar cuando nada más coincide.
¿Uso en-uk o en-gb?
en-gb. La parte de región es un código de país ISO 3166-1 Alpha 2, y el código del Reino Unido es GB. en-uk no es un valor válido. Hay más respuestas como esta en las hreflang and international SEO FAQ de SEO ProCheck.
¿Qué método de hreflang es mejor?
Cualquiera de los tres funciona para Google: etiquetas link en el head del HTML, la cabecera HTTP Link o el sitemap XML. Usa un método por conjunto. Las etiquetas link son las más fáciles de revisar, la cabecera va bien para los PDF y los sitemaps sacan los conjuntos grandes de la página.