Generador de hreflang y validador

hreflang indica a los buscadores que una página tiene versiones en otros idiomas o para otros países. Google usa estos enlaces para mostrar a cada usuario la versión adecuada: a alguien en México, /mx/precios con precios en pesos; a alguien en España, /es/precios en euros. No es un factor de posicionamiento como tal: ayuda a elegir qué URL mostrar.

Google admite tres métodos de marcado equivalentes:

El valor del atributo es un código de idioma ISO 639-1, opcionalmente seguido de un código de país ISO 3166-1 alfa-2 tras un guion: es, es-MX, es-AR. El valor especial x-default marca la página para todos los demás: un selector de idioma o la versión principal.

Un sitio en un solo idioma y para un solo mercado no necesita hreflang. Hace falta cuando la misma página existe en varias variantes: traducciones, versiones regionales con precios y monedas distintos, o sitios en español para varios países con textos adaptados.

Reciprocidad y autorreferencia

La regla clave de la documentación de Google: los enlaces deben ser recíprocos. Si la versión mexicana apunta a la española, la española debe apuntar de vuelta a la mexicana; si no, el marcado puede ignorarse. Además, cada versión se incluye a sí misma. Lo más sencillo es poner el mismo conjunto completo en todas las versiones, que es justo lo que genera la herramienta.

Códigos

• El idioma es siempre obligatorio; el país, solo junto a un idioma. hreflang="MX" es un error: usa es-MX.
• El separador es un guion. es_MX aparece en los locales del software y en og:locale, pero en hreflang lo correcto es es-MX.
• No existe un código de país para «Latinoamérica»: es-LA significa español para Laos. La región numérica es-419 es válida en BCP 47, pero Google solo documenta países de dos letras, así que es más seguro enumerar es-MX, es-AR, es-CO…
• Un idioma sin país funciona como respaldo para todos los países. Si tienes es-ES y es-MX, añade es para los hispanohablantes de otros países, por ejemplo apuntando a la versión latinoamericana.

hreflang y canonical

Cada versión debe ser canónica de sí misma. Un error habitual es apuntar el rel="canonical" de todas las variantes a la versión de España: eso declara las demás como duplicados y los buscadores pueden no mostrarlas. Esto pasa mucho con versiones por país casi idénticas: si /mx/ y /es/ solo se diferencian en la moneda, mantén el canonical propio en cada una y deja que hreflang explique la relación. Las URL de hreflang deben coincidir con las canónicas: sin parámetros extra, con el mismo protocolo y la misma barra final.

URL

Usa URL completas con protocolo y dominio: https://example.com/mx/, no /mx/. Las versiones pueden estar en dominios distintos (example.com.mx, example.es): hreflang funciona entre dominios. Las páginas del conjunto deben devolver 200 y no estar bloqueadas para la indexación.

Google se basa en hreflang. Bing históricamente ha recomendado el atributo lang de HTML o la metaetiqueta content-language y una estructura de URL clara, y da menos peso a hreflang. En la práctica, pon tanto el atributo lang como hreflang.

Dominios de país, subdominios o subcarpetas

La guía de Google para sitios multirregionales y multilingües compara las opciones así:

• Dominios de país (example.com.mx, example.es): la señal de país más clara, pero cada dominio se compra, se mantiene y se hace crecer por separado.
• Subdominios (mx.example.com): fáciles de alojar por separado; la relación con el sitio principal es menos evidente para los usuarios.
• Subcarpetas (example.com/mx/): lo más fácil de mantener, un solo host y un historial de dominio compartido. Para un SaaS suele ser la opción más práctica.
• Parámetros de URL (?pais=mx): Google no los recomienda, porque dificultan saber qué versión ve el usuario.

Elijas lo que elijas, no redirijas automáticamente a los usuarios por IP o por idioma del navegador. Los rastreadores podrían no ver nunca las demás versiones, y la gente podría no llegar a la que quería. Muestra un selector de idioma o país visible y deja que hreflang indique a los buscadores la URL correcta.

• Sin enlaces de vuelta. El marcado se añadió solo en la versión principal y las demás no enlazan a ella.
• Sin autorreferencia. La página enumera todas las versiones menos ella misma.
• Códigos no válidos: es_MX, es-LA para Latinoamérica, mx sin idioma, códigos de tres letras como spa.
• URL relativas, o con parámetros de seguimiento o #fragmentos.
• Canonical hacia otra versión. Las variantes quedan declaradas como duplicados de la principal.
• Versiones bloqueadas para la indexación en robots.txt o con noindex: el enlace apunta a una página que el buscador no puede usar.
• Un código, dos URL. Dos URL distintas con hreflang="es" en el mismo conjunto.
• Páginas sin adaptar. Una versión «para México» idéntica a la de España, con euros y «ordenador», es un duplicado, no una versión regional.
• Marcado en varios sitios que no coincide: un conjunto en el HTML y otro en el sitemap.

1. Google Search Central. Informar a Google sobre las versiones localizadas de tu página — developers.google.com/search/docs/specialty/international/localized-versions.
2. Google Search Central. Gestionar sitios multirregionales y multilingües — developers.google.com/search/docs/specialty/international/managing-multi-regional-sites.
3. ISO 639-1:2002. Codes for the representation of names of languages — Part 1: Alpha-2 code; registro — loc.gov/standards/iso639-2.
4. ISO 3166-1. Codes for the representation of names of countries — iso.org/iso-3166-country-codes.html.
5. RFC 5646 (BCP 47). Tags for Identifying Languages. IETF, 2009.
6. Sitemaps.org. Sitemap protocol — sitemaps.org/protocol.html.
7. Bing Webmaster Blog. How to optimize your content for search in multiple languages and regions — blogs.bing.com/webmaster.