Etiquetas hreflang explicadas, con generador y ejemplos | We.Inc
Cómo marca hreflang las versiones por idioma y por región: códigos válidos, x-default, enlaces de retorno, métodos con HTML, cabeceras y sitemap, errores habituales y un generador.
Etiquetas hreflang explicadas
Hreflang indica a los buscadores qué URL mostrar para cada idioma o región. Cada versión de una página se incluye a sí misma y a todas sus alternativas con link rel="alternate" hreflang="code" y una URL completa. Los códigos son un idioma ISO 639-1, seguido opcionalmente de una región ISO 3166-1 como en-GB, y x-default cubre a todos los demás.
Códigos válidos y no válidos
Código
¿Válido?
Significado
Sí
Inglés, cualquier región
en-GB
Sí
Inglés para usuarios del Reino Unido
zh-Hant
Sí
Chino en escritura tradicional (código de escritura ISO 15924)
No (para Google)
Las regiones numéricas no se admiten
Sí
Opción de respaldo cuando ninguna otra versión coincide
GB
No
No se permite la región sola
en-UK
No
El código de región del Reino Unido es GB
La mayoría de los problemas con hreflang son de contabilidad: una página olvida enlazar de vuelta, un código usa la región equivocada o las URL son relativas. El generador de abajo crea de una vez el conjunto completo y simétrico para todas las versiones, para que cada página lleve la misma lista completa.
Añade una fila por cada versión de idioma o región con su código y su URL completa.
Si quieres, marca una URL como x-default, a menudo un selector de idioma o tu versión principal.
Copia las etiquetas link en el head de cada versión, o usa en su lugar el resultado para el sitemap.
Tras el siguiente rastreo, inspecciona algunas de las URL en Search Console para confirmar que Google ha detectado el conjunto.
Pon exactamente el mismo conjunto de etiquetas en cada versión. Las etiquetas de la página en inglés y de la página en francés deben ser la misma lista.
Usa un solo método por conjunto de páginas. Mezclar etiquetas HTML con entradas del sitemap hace más difícil mantenerlos sincronizados.
Hreflang es una pista sobre qué versión mostrar. No traduce nada, y Google dice que detecta el idioma de una página con sus propios algoritmos, no a partir de hreflang.
Preguntas frecuentes
¿Necesito una etiqueta hreflang que apunte a la propia página?
Sí. La documentación de Google dice que cada versión debe incluirse a sí misma además de todas las demás versiones. Sin la autorreferencia el conjunto está incompleto.
¿Para qué sirve x-default?
x-default indica la página que se muestra cuando el idioma o la región de quien busca no coincide con ninguna de tus versiones. Lo habitual es una página de selección de idioma o tu página de inicio internacional.
¿Qué pasa si la página B no enlaza de vuelta a la página A?
Google exige que los enlaces vayan en ambos sentidos. Si A apunta a B pero B no apunta de vuelta a A, la anotación puede ignorarse. Los enlaces de retorno impiden que terceros se presenten como alternativa de tu página.
¿Debo usar etiquetas HTML, cabeceras HTTP o el sitemap?
Google trata los tres como equivalentes. Las etiquetas HTML encajan en la mayoría de los sitios. Las cabeceras HTTP Link son la opción para los PDF y otros archivos que no son HTML. Un sitemap mantiene el marcado fuera de tus páginas y es más cómodo para sitios grandes con muchos idiomas.
¿Puedo dirigirme a un país sin indicar idioma?
No. Un código de región por sí solo no es válido. Para dirigirte a Canadá en inglés y en francés, usa en-CA y fr-CA.
Cuándo vale la pena añadir hreflang
Úsalo cuando el mismo contenido exista en más de un idioma, o en un solo idioma con diferencias regionales reales como precios, ortografía o condiciones de envío. Ayuda a Google a enviar a quien busca desde México a la página en español de México en lugar de a la de España.
Un sitio en un solo idioma para un solo mercado no necesita hreflang. Añadirlo ahí solo crea otra cosa más que mantener.
Errores habituales
Las URL relativas no se aceptan; el href debe incluir https y el host. Los guiones bajos son incorrectos en hreflang: escribe en-GB, no en_GB, que es el estilo de locale de Open Graph.
Incluir una URL que redirige o devuelve un error desperdicia la anotación. Limita el conjunto a direcciones finales y activas, y actualízalo cada vez que añadas o quites una página traducida.
Las tres formas de declarar alternativas
Etiquetas link de HTML en el head
Las mismas cinco líneas van en las páginas en inglés, en inglés británico, en alemán y en la de selección.
Cabecera HTTP Link para un PDF
La envía el servidor junto con el archivo, ya que un PDF no tiene head donde poner etiquetas.
Entradas del sitemap
Cada elemento url enumera todas las versiones, incluida la propia. El namespace xhtml debe declararse en urlset.
Errores y cómo corregirlos
Lo que falla con más frecuencia
Problema
Solución
Falta el enlace de retorno
Añade el conjunto completo de etiquetas a cada versión
Región sin idioma, como hreflang="US"
Usa idioma más región, como en-US
Código de región incorrecto, como en-UK
Usa el código ISO 3166-1 GB
href relativo
Escribe la URL completa con https y host
La URL alternativa redirige o devuelve 404
Incluye solo URL finales y activas
La región sola no es válida; añade un idioma, como en-{code}
Usa un guion, no un guion bajo
El código de región del Reino Unido es GB
Se esperaba un formato como en, en-GB o zh-Hant
La URL debe ser absoluta, con https y host
El mismo código aparece dos veces
Generador de hreflang
Añade el código y la URL completa de cada versión. El generador comprueba los códigos y escribe de una vez el conjunto de etiquetas y el bloque de sitemap para todas las versiones.
Código
URL
Quitar {name}
Quitar fila
Quitar
Añadir versión
URL x-default (opcional)
Formato de salida
Etiquetas HTML
Sitemap
Los códigos y las URL parecen válidos. Pon este mismo conjunto en cada versión.