Generador de hreflang — crea etiquetas para sitios multilingües
Sin hreflang, Google puede tratar tus páginas traducidas como duplicadas y mostrar la versión en el idioma equivocado en la búsqueda. Convierte un conjunto de URLs de idioma en marcado hreflang en tres formas: etiquetas <link>, cabecera HTTP Link y sitemap <xhtml:link>. Pasos: pega cada URL de idioma con su código, elige una forma y copia el fragmento generado. Cada URL recibe su propia anotación de autorreferencia, y se puede añadir un respaldo x-default opcional. Funciona íntegramente en tu dispositivo: no se sube nada. Ejemplo: tres versiones de una página en en, es y ja.
Cómo funciona
El generador analiza cada línea en un código de idioma y una URL, y luego renderiza el mismo conjunto de relaciones en tres formas. La forma <link> va en el <head> de cada página. La forma de cabecera HTTP Link se envía en la respuesta del servidor. La forma sitemap incrusta <xhtml:link> dentro de cada bloque <url>. Cada URL recibe una anotación hreflang de autorreferencia para que cada versión de idioma apunte a sí misma, y la entrada x-default opcional cubre a los visitantes cuyo idioma no aparece.
Reglas usadas por el generador
Estas reglas provienen de Google Search Central y del estándar de etiquetas BCP 47.
- Cada versión de idioma debe incluir una anotación hreflang de autorreferencia que apunte a su propia URL. Omitirla debilita la señal.
- Cada URL debe aparecer desde todas las versiones: el conjunto completo de alternativas está en cada página, no solo en una dirección.
- Los códigos de idioma usan BCP 47: un idioma de dos letras, opcionalmente una región (en-US) y opcionalmente un sistema de escritura (zh-Hans). x-default es el código de respaldo especial.
- x-default apunta a la página mostrada cuando ningún idioma listado coincide, por ejemplo una raíz en inglés. Google puede usarla como respaldo para todos los idiomas no detectados.
- Elige una sola forma de entrega por conjunto: las etiquetas <link> en HTML, la cabecera HTTP Link o xhtml:link en sitemap. No mezcles formas en el mismo conjunto, o las señales pueden contradecirse.
Ejemplo
La muestra lista tres versiones de una página: https://example.com/ (en), https://example.com/es/ (es) y https://example.com/ja/ (ja). Las etiquetas <link> generadas incluyen autorreferencias para cada idioma más un x-default opcional que apunta a la raíz en inglés.
Buenos usos
- Lanzar un sitio multilingüe: genera las etiquetas <link> una vez por plantilla y verifica que cada versión de idioma liste el conjunto completo.
- Tras una reestructuración del sitio, regenera el marcado para que el mapeo de URLs se mantenga coherente entre idiomas.
- Cuando los resultados de búsqueda muestran el idioma equivocado, comprueba que existan autorreferencias y x-default y que las URLs apunten a páginas canónicas.
Frequently asked questions
¿Cuál de las tres formas debo usar?
Usa las etiquetas <link> si puedes editar el HTML. Usa la cabecera HTTP Link cuando el servidor es tuyo y cuesta cambiar el HTML. Usa la forma sitemap si prefieres mantenerlo en el sitemap XML.
¿Cuándo debo añadir x-default?
x-default indica a Google qué versión mostrar cuando el idioma del visitante no coincide con ningún código listado. Añádelo cuando tengas una raíz o página de respaldo, normalmente en inglés.
¿Cada URL necesita una hreflang de autorreferencia?
Sí. Cada versión de idioma debe incluir su propia URL en el conjunto, con una hreflang de autorreferencia que apunte a sí misma. Google usa el conjunto completo para elegir la página correcta por idioma.
¿Qué formato de código de idioma es válido?
Códigos BCP 47: un idioma de dos o tres letras, opcionalmente una región (en-US) y opcionalmente un sistema de escritura (zh-Hans). El idioma en minúsculas, y no inventes códigos como «en-us-en».
¿Hreflang va en <head> o en el sitemap?
Cualquiera funciona, pero usa una sola forma coherente por conjunto de páginas. Las etiquetas <link> van en <head>, la cabecera HTTP Link se envía con la respuesta, y el sitemap usa bloques xhtml:link.
¿Mis URLs se suben a algún sitio?
No. El generador funciona íntegramente en tu navegador y no se sube nada.
Consultas o comentarios
¿Algo poco claro, roto o que falte? Redacta un mensaje abajo — leemos cada nota sobre estas herramientas.