Cómo se usa
- Escriba una fila por versión por idioma en Versiones por idioma: el código, una barra vertical y la dirección completa.
- Si tiene un selector de idioma o una página por defecto, escriba su dirección en Dirección de respaldo (x-default).
- Lea Revisión de las filas. Cuando indique que todas las versiones son válidas, copie los elementos link, el sitemap o la cabecera.
- Ponga el mismo conjunto en cada página y compruebe que cada versión enlaza de vuelta con todas las demás.
Cómo se revisan los códigos
La parte de idioma debe ser un código de dos letras ISO 639-1: la lista de la Biblioteca del Congreso tiene 183. La región opcional debe ser un código ISO 3166-1 alfa-2 asignado oficialmente, como GB o TW. La guía de Google dice que solo se admiten esas dos normas, y que el idioma va primero, así que una región sola, como GB, se rechaza.
Una parte de escritura, como Hant o Hans, debe tener cuatro letras. La guía de Google dice que las escrituras se dan según ISO 15924; esta herramienta revisa la forma de la escritura y no la lista completa. Los códigos no distinguen mayúsculas, así que la herramienta escribe el idioma en minúsculas, la región en mayúsculas y la escritura con mayúscula inicial.
- en-uk se rechaza porque UK es un código reservado; el Reino Unido es GB, así que la herramienta sugiere en-GB.
- iw, in y ji se cambiaron en 1989 por he, id y yi, así que la herramienta sugiere esos códigos.
- Los códigos que no coinciden con nada, como xx, eng o en_US, se rechazan con el número de línea.
Tres formas de enviar el mismo grupo
Google enumera tres métodos: elementos link en la cabecera HTML, cabeceras HTTP y un sitemap XML. Google dice que los tres son equivalentes, así que elija el más fácil de mantener. La forma de sitemap necesita el espacio de nombres xhtml, y cada entrada url enumera todas las alternativas, incluida ella misma.
El método de cabecera HTTP se describe para la respuesta GET de cualquier página; Google lo considera útil para archivos que no son HTML, como los PDF, y sus ejemplos son PDF. Para una página web, lo habitual son los elementos link o el sitemap. Google también dice que la cabecera Link devuelta para cada versión de una página es idéntica, así que esta herramienta escribe un solo valor para todo el grupo.
Enlaces de vuelta y x-default
Cada versión tiene que enumerarse a sí misma y a todas las demás versiones, y cada página debe apuntar de vuelta. Google dice: «Si dos páginas no se apuntan mutuamente, las etiquetas se ignorarán». Cuando un grupo es difícil de mantener completo, Google dice que puede omitir algunos idiomas en algunas páginas, y sigue procesando los pares que se apuntan mutuamente.
x-default indica la página de respaldo para los idiomas que no coinciden con ninguna de sus versiones. Google la recomienda para las páginas de selección de idioma, y se escribe sin código de idioma.
Ejemplo resuelto: tres versiones y un respaldo
Las filas en | https://example.com/en/, en-GB | https://example.com/en-gb/ y tr | https://example.com/tr/, con https://example.com/ como respaldo, forman cuatro alternativas. Cada página del grupo recibe los mismos cuatro elementos link, y el sitemap tiene una entrada url para cada una de las tres páginas.
Cada entrada url enumera las cuatro alternativas. La línea de estado indica que todas las versiones son válidas: 3 en total, porque el respaldo no es una versión por idioma.
| Salida | Cantidad | Detalle |
|---|---|---|
| Elementos link | 4 | hreflang="tr" href="https://example.com/tr/" |
| Entradas url del sitemap | 3 | cada una enumera 4 alternativas, con x-default incluido |
| Valores de la cabecera Link | 1 | el mismo valor en cada página, con 4 alternativas |
| Versiones por idioma | 3 | estado: todas las versiones son válidas: 3 en total |
Preguntas frecuentes
¿Qué códigos son válidos?
Un código de idioma de ISO 639-1, como en, tr o zh, puede ir seguido de una escritura de cuatro letras, como Hant, y de una región ISO 3166-1, como GB o TW. Los códigos no distinguen mayúsculas, y la herramienta los escribe con la forma estándar.
¿Por qué se indica en-uk como error?
UK es un código reservado en ISO 3166-1, y la guía de Google dice que UK en hreflang no tiene efecto. El código asignado al Reino Unido es GB, así que la etiqueta correcta es en-GB.
¿Necesito una fila x-default?
No es obligatoria. Google llama a x-default el respaldo para los idiomas que no coinciden con ninguna de sus versiones, y lo recomienda para los selectores de idioma. La herramienta lo añade solo cuando usted escribe una dirección.
¿Cada página debe enumerar todo el grupo?
Cada versión debe enumerarse a sí misma y a todas las demás. Google dice que las etiquetas se ignoran cuando dos páginas no se apuntan entre sí, pero también dice que puede omitir un idioma en algunas páginas, y seguirá procesando los pares que se enlazan.
¿Por qué la herramienta acepta solo direcciones https?
Acepta direcciones https absolutas, que hoy usan la mayoría de los sitios. Google exige direcciones completas que incluyan el método de transporte, así que un sitio que aún funciona en http necesita escribir sus anotaciones a mano.
¿El método de cabecera HTTP es para páginas web?
Google lo describe para la respuesta GET de cualquier página, y dice que es útil para archivos que no son HTML, como los PDF. Para las páginas web, lo habitual son los elementos link o el sitemap.
¿La herramienta envía mis direcciones a algún sitio?
No. El resultado se construye en su navegador a partir del texto que escribe, y nada se envía a un servidor.
Fuentes
- Google Search Central: versiones localizadas y hreflang (en inglés)
- Library of Congress: lista de códigos ISO 639-2 con los códigos ISO 639-1 (en inglés)
- Wikipedia (en inglés): ISO 639-1, 183 códigos registrados
- Wikipedia (en inglés): List of ISO 639 language codes, códigos cambiados en 1989
- Wikipedia (en inglés): ISO 3166-1 alfa-2, códigos asignados oficialmente; UK está reservado
- Sitemaps.org: protocolo, escape de entidades (en inglés)
Cifras y texto revisados por última vez el martes, 10 de noviembre de 2026.