Generador y validador de hreflang
Añade una fila por cada versión regional de la misma página. La configuración regional puede detectarse desde la URL y cada página puede tener su propio x-default opcional.
| hreflang | URL | x-default (opcional, por página) | Borrar |
|---|
Configura una plantilla de URL por idioma con {path} como marcador y pega una ruta por línea.
| hreflang | Plantilla para URL | x-default plantilla para url (opcional, por página) | Borrar |
|---|
Pega filas CSV/TSV de idioma,URL o un sitemap.xml con entradas xhtml:link. Todo se analiza en tu navegador.
Añade una configuración regional y una URL arriba para ver el resultado.Se ejecuta por completo en tu navegador: nada de lo que pegues se sube ni se almacena. Los contadores anónimos de resultados por ejecución pueden utilizarse para investigación agregada; nunca incluyen URL, dominios, IP ni identificadores, y no se publica ninguna estadística con menos de 100 ejecuciones.
Obtén una página ya publicada: leemos sus anotaciones hreflang y después cada alternativa declarada (hasta 25) para verificar enlaces de retorno y autorreferencias.
+ guarda el sitio o la página actuales. Usa ☆ junto a cualquier sitio, página o lista guardados para añadirlos a favoritos. El historial de comprobaciones recientes aparece debajo.
Crear una lista con nombre
Destino rellenado desde tus selecciones locales.
Pasaporte del sitio Contexto local de este sitio guardado
Datos locales
Los destinos guardados, las listas con nombre y los resúmenes de comprobaciones recientes permanecen solo en este navegador.
Valorar esta herramienta
Las comprobaciones se ejecutan desde nuestro servidor; consultamos la URL que introduces y no conservamos los resultados. Los contadores anónimos de resultados por ejecución pueden utilizarse para investigación agregada; nunca incluyen URL, dominios, IP ni identificadores, y no se publica ninguna estadística con menos de 100 ejecuciones.
Informe de ejemplo para la herramienta
Un sitio en inglés de EE. UU. y Reino Unido, con un respaldo genérico en y un x-default, produce etiquetas head como estas:
<link rel="alternate" hreflang="en-US" href="https://example.com/us/" />
<link rel="alternate" hreflang="en-GB" href="https://example.com/uk/" />
<link rel="alternate" hreflang="en" href="https://example.com/us/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/" />…y al ejecutar ese clúster con el validador integrado se obtiene:
Los códigos se normalizan automáticamente. Escribe en-us o en-US — el generador siempre emite la región en mayúsculas (en-US), así que los errores de mayúsculas no causan problemas.
El código genérico
enes lo que hace que esto funcione. Captura a los usuarios de habla inglesa fuera de EE. UU. y Reino Unido que no coincidirían con nada; consulta variantes regionales sin un respaldo genérico.x-defaultcubre a todos los demás; consulta la ausencia de x-default para ver qué ocurre sin él.La bidireccionalidad no se ve en las etiquetas de una sola página, pero este generador emite el mismo bloque completo en cada página del conjunto: cada URL enumerada también enlaza de vuelta a esta automáticamente.
Pruébalo: pega
en-uken lugar deen-gby el validador muestra un problema que señala la corrección; consulta el formato de los códigos.
Cómo usarla
Añade una fila por página y una columna por idioma o región; después completa cada URL.
Opcionalmente, establece un x-default por fila e importa un sitemap existente para crear un clúster.
Copia las etiquetas head, el XML del sitemap o las cabeceras HTTP Link; cada página recibe un clúster bidireccional completo.
Pega el marcado publicado o comprueba una URL para detectar errores habituales antes de publicar.
Cómo funciona (y cómo se rompe hreflang)
Úsalo cuando controles las plantillas HTML de las páginas habituales.
Suele ser la opción más clara: muestra el mismo clúster completo en el head de cada página.
Úsalo cuando sea difícil cambiar las plantillas o gestiones muchas variantes de URL de forma centralizada.
Usa entradas xhtml:link de forma coherente y mantén el sitemap accesible para los rastreadores.
Úsalo cuando el alternativo sea un archivo descargable u otro recurso que no sea HTML.
Es la opción práctica para archivos que no tienen head HTML. Evita mezclar métodos sin un motivo.
hreflang indica a los buscadores qué versiones lingüísticas o regionales de una página existen para que cada usuario reciba la adecuada. Hay tres métodos equivalentes: etiquetas <link rel="alternate"> en el <head>, entradas xhtml:link en un sitemap XML o cabeceras HTTP Link, la única opción para PDF y otros archivos no HTML. Elige un método por página; mezclar métodos puede crear conflictos.
Las dos reglas que rompen la mayoría de las implementaciones son estas: cada página debe incluir una entrada autorreferente y cada par debe ser bidireccional; si A enumera B, B debe enumerar A de vuelta o el par se ignora. Como este generador emite el clúster completo en cada página, ambas reglas se cumplen automáticamente.
Variantes regionales sin un respaldo genérico
Si publicas en-US y en-GB sin un en genérico, las personas angloparlantes de otros mercados no encontrarán coincidencia y Google elegirá por ellas. Añade una entrada en genérica; puede apuntar a la página correspondiente que trates como predeterminada.
Falta el x-default.
x-default nombra la página para usuarios que no coinciden con ningún idioma declarado; normalmente es el selector de idioma o tu versión principal. Es opcional y esta herramienta solo muestra una advertencia, pero es preferible explicitarlo a dejar que el algoritmo elija.
Una página independiente de selección de idioma también necesita las anotaciones: coloca en ella el mismo bloque de etiquetas head; la línea x-default es su autorreferencia, por lo que el clúster sigue siendo bidireccional. En el sitemap, una URL de selector que no es una página local recibe automáticamente su propia entrada <url> anotada.
x-default también es una anotación por página: las páginas del mismo clúster pueden apuntar a distintos x-default; la página francesa a un selector en francés y la inglesa a uno en inglés. Usa la columna x-default por fila; cuando las páginas difieren, la salida cambia a un bloque por página y cada selector distinto recibe su propia entrada de sitemap anotada.
Las URL con http/https mezclados y barras finales incoherentes.
Las URL hreflang deben coincidir exactamente con la URL canonical. Si una parte usa http:// o elimina la barra final a la que redirige tu sitio, esos alternativos pasan por redirecciones y Google suele descartarlos. Usa la forma final y canonical de cada URL.
Códigos de idioma obsoletos
Algunos códigos ISO 639-1 cambiaron y permanecen en exportaciones antiguas de sistemas de gestión: in → id (indonesio), iw → he (hebreo), ji → yi (yidis). Los buscadores suelen tolerar las formas antiguas, pero usa los códigos actuales.
Formato de los códigos
Los valores son idioma o idioma-REGIÓN: un idioma ISO 639-1 de dos letras y, opcionalmente, una región ISO 3166-1 alpha-2. La trampa clásica es en-uk: el código de región del Reino Unido es GB. Los subcódigos de script como zh-Hant / zh-Hans también son válidos. Los guiones bajos (en_US) no lo son. La coincidencia no distingue mayúsculas, así que el uso de mayúsculas es solo cosmético.
Explora los códigos de idioma y región
Busca los códigos de idioma ISO 639-1 y de región ISO 3166-1 que acepta el generador. Los alias de idioma obsoletos aparecen junto con su reemplazo.
Idiomas de la herramienta (188)
Regiones de la herramienta (249)
Metodología
La herramienta construye el clúster a partir de una fila por URL y por idioma, normaliza los subcódigos y emite el mismo conjunto completo, incluidas las autorreferencias, para cada página. Después aplica reglas deterministas a códigos, URL, duplicados, protocolos, barras finales, x-default y reciprocidad. En una comprobación publicada, obtiene la URL indicada y hasta 25 alternativas para comparar enlaces de retorno, autorreferencias y canonicalización. Todo ocurre en el navegador salvo la solicitud opcional de comprobación publicada.
Funciones de la herramienta
Genera un clúster completo y bidireccional para cada conjunto de páginas, incluidas las autorreferencias.
Exporta etiquetas del head, XML de sitemap con división automática por encima de 50 000 URL, cabeceras HTTP Link y fragmentos para varios frameworks web.
Normaliza los códigos de idioma y región y detecta guiones bajos, códigos obsoletos y regiones no válidas.
Esta comprobación detecta idiomas y URL duplicados, protocolos mixtos, barras finales incoherentes, fallos de reciprocidad y ausencia de x-default.
Importa filas CSV o TSV o entradas xhtml:link de un sitemap y ejecuta el análisis completamente en el navegador.
Comprueba una URL publicada y hasta 25 alternativas declaradas para verificar enlaces de retorno y autorreferencias.
Limitaciones de la herramienta
Se ejecuta en el navegador; los datos pegados y la generación en el equipo no consultan una base de datos de búsquedas.
La comprobación de una URL publicada depende de que la página sea accesible y está limitada a 25 alternativas y un cuerpo decodificado de 2 MiB.
El validador comprueba lo que proporcionas; no puede confirmar la indexación de Google, el contenido privado ni si un buscador elegirá una URL.
La división del sitemap se aplica al resultado generado por encima de 50 000 URL; la descarga incluye el índice y cada parte.
Preguntas frecuentes para la herramienta
¿Dónde van las etiquetas hreflang: en el head, el sitemap o una cabecera HTTP?
En cualquiera de los tres, y son equivalentes, pero elige un método por página. Usa etiquetas <link rel="alternate"> en el <head> HTML, entradas xhtml:link en un sitemap XML o una cabecera HTTP Link —la única opción para archivos no HTML, como los PDF—. Mezclar métodos en la misma página favorece los conflictos.
¿Qué es x-default y necesito usarlo?
x-default identifica la página que se sirve a los usuarios que no coinciden con ninguno de tus locales declarados; normalmente es un selector de idioma o tu versión principal. Es opcional, pero es mejor hacerlo explícito que dejar que el algoritmo elija, así que se recomienda para la mayoría de los sitios.
¿Por qué se ignoran mis etiquetas hreflang?
Casi siempre por una de estas tres razones: las anotaciones no son bidireccionales —la página A enumera B, pero B no enlaza de vuelta a A—, a una página le falta su entrada autorreferente o las URL no coinciden con la forma canónica —por ejemplo, http frente a https o una barra final que el sitio redirige— y pasan por redirecciones. Este generador emite el clúster bidireccional completo con autorreferencias para evitar las dos primeras causas.
¿Las etiquetas hreflang y canonical entran en conflicto?
Ambas deben concordar. Cada versión lingüística necesita una URL principal autorreferente —es decir, su propia URL, nunca la de otro idioma— y cada URL indicada mediante hreflang debe ser la versión principal de esa página. Google suele descartar las referencias hreflang dirigidas hacia una URL secundaria o con redirecciones.
¿Es en-uk un valor hreflang válido?
No. El código de región del Reino Unido es GB, así que usa en-gb. Los valores hreflang son un código de idioma ISO 639-1 más un código de región ISO 3166-1 alpha-2 opcional; en-uk es el error más común.
Problemas habituales y cómo solucionarlos
- Error El código de idioma no es válido Solución: Sustituye el subcódigo de idioma por un código ISO 639-1 válido, como en, fr o de.
- Error El código de región no es válido Solución: Sustituye el subcódigo de región por un código ISO 3166-1 alpha-2 válido en mayúsculas, como US o GB.
- Error hreflang usa un guion bajo en lugar de un guion Solución: Cambia el separador de la configuración regional de guion bajo a guion, por ejemplo en_US → en-US.
- Error La configuración regional está duplicada Solución: Conserva una alternativa por valor de idioma-región y elimina o combina la fila de configuración regional duplicada.
- Advertencia La URL está asignada a varias configuraciones regionales Solución: Asigna cada URL alternativa a su configuración regional real y elimina cualquier segunda configuración regional que apunte a la misma página localizada.
- Advertencia Falta la alternativa x-default Solución: Añade una alternativa x-default que apunte al selector de idioma neutro o a la página predeterminada más adecuada para usuarios sin coincidencia.
- Error La URL alternativa no es válida Solución: Corrige la alternativa para que sea una URL http:// o https:// interpretable, sin espacios ni caracteres mal formados.
- Error La URL alternativa no es absoluta Solución: Convierte la alternativa relativa en su URL canónica https:// completa, incluido el nombre de host y la ruta.