Cómo usarla
- Añade una fila por cada versión lingüística o regional: el código (como de o de-AT) y la URL completa https:// de esa versión.
- Si quieres, añade una URL x-default para los visitantes cuyo idioma no esté contemplado.
- Corrige los errores que se muestran junto a las filas y, después, elige etiquetas HTML, entradas de sitemap XML o una cabecera HTTP.
- Copia el código y añade el mismo conjunto a todas las páginas de la lista, para que cada página incluya todas las versiones, incluida la suya.
Cómo funciona
hreflang indica a los motores de búsqueda qué URL corresponde a cada versión regional o en otro idioma de un mismo contenido. Así, por ejemplo, una persona que busca desde Austria puede ver la página de-AT en lugar de la página de-DE. El valor es un código de idioma ISO 639-1, seguido opcionalmente de un código de región ISO 3166-1 alpha-2; una región sola (como «GB») no es válida. La herramienta detecta errores habituales como en-UK (el código correcto es en-GB), regiones que no son países, como EU, y códigos duplicados. Los códigos se comprueban con los datos de idiomas y regiones integrados en tu navegador.
Las anotaciones deben ser bidireccionales y autorreferenciales: cada página del conjunto debe incluir todas las versiones, incluida ella misma. Si la página alemana enlaza a la francesa, pero la francesa no enlaza de vuelta, los motores de búsqueda pueden ignorar esa relación. x-default señala la página alternativa para el resto de los usuarios. Usa URL absolutas y dirige cada hreflang a la versión canónica de esa página, no a una redirección ni a una página con una etiqueta noindex.
Hay tres formas equivalentes de publicar las anotaciones: elementos link en la sección head del HTML, entradas xhtml:link en un mapa del sitio XML o un encabezado HTTP Link. Elige un método para cada conjunto de páginas; no hace falta usar más de uno. hreflang es una indicación para elegir entre versiones, no una mejora del posicionamiento.
Ejemplos
Sitio en inglés y alemán
Las filas en → https://example.com/ y de → https://example.com/de/ más x-default → https://example.com/ generan tres etiquetas link. Tanto la página en inglés como la alemana deben incluir las tres.
Español de España y México
Usa es-ES y es-MX para las dos versiones regionales y añade una versión es sin región (o dirige es a una de ellas) para incluir también a los hispanohablantes de otros países.
Corregir un error habitual
Se señala en-UK: UK no es el código ISO 3166-1 del Reino Unido. Cámbialo por en-GB.
Preguntas frecuentes
¿Necesito x-default?
Es opcional, pero recomendable. Indica a los motores de búsqueda qué página mostrar cuando ninguno de los idiomas o regiones especificados coincide con los del usuario; por ejemplo, una página global en inglés o un selector de idioma.
¿Puedo usar una región sin idioma, como hreflang="us"?
No. El idioma es obligatorio; la región es opcional. «us» no es un código de idioma. Usa en-US.
¿Debo usar etiquetas HTML o el mapa del sitio?
Ambas opciones funcionan. Las etiquetas HTML son la opción más sencilla para sitios pequeños. Los mapas del sitio mantienen reducido el HTML de las páginas y son más fáciles de gestionar cuando hay muchos idiomas. Los encabezados HTTP se usan principalmente para PDF y otros archivos que no son HTML.
¿Pueden dos códigos de idioma apuntar a la misma URL?
Sí. Por ejemplo, en-GB y en-IE pueden apuntar a la misma página en inglés británico. Lo que no se permite es que el mismo código apunte a dos URL diferentes.
Privacidad
Los códigos y las URL se validan y se formatean en tu navegador. No se envía ni se guarda nada.