What is hreflang and when do I need it?

Hreflang is an HTML attribute that tells Google which version of a page to show users in different languages or regions. You need it when the same content exists in multiple translations or regional variants (e.g., en-US vs en-GB). Without it, Google may show the wrong language or treat your translations as duplicate content.

Do hreflang tags need to be bidirectional?

Yes. Every page in a hreflang group must reference every other page, including itself. If the English page references the Spanish version, the Spanish version must reference the English back. Google ignores hreflang tags that aren't reciprocal.

What is the x-default hreflang and is it required?

x-default specifies the fallback page shown when no locale-specific version matches a user's settings. It's strongly recommended (especially for global homepage layouts) but not strictly required. We recommend always including it.

Why is Google ignoring my hreflang tags?

The #1 reason is missing return tags — page A points to page B as an alternate, but B does not point back to A. Google requires every page in a group to reference every other page (including itself). Other common causes: malformed locale codes (use ISO 639-1 plus ISO 3166-1, not country names), pointing to redirecting URLs, or mixing canonical and hreflang in conflicting ways. Use the Validate tab to surface these before publishing.

Do I need self-referencing hreflang tags?

Yes — strongly recommended. Each page should list itself as one of the alternates in its own hreflang block (for example, the English page declares en-US as one of its alternates pointing to its own URL). Without a self-reference, Google may treat the group as ambiguous and pick an unpredictable variant for search results.

Can I bulk-import locales from a CSV?

Yes. Drop a CSV file with two columns — locale, URL — onto the dropzone in Generate mode. A header row (locale,url) is auto-detected and skipped. Empty rows are filtered out. The status message reports how many locales loaded.

Should I put hreflang in HTML head or in sitemap.xml?

Both work — Google treats them equivalently. Link tags in the head are easier for small sites. XML sitemap declarations scale better for large sites with hundreds of alternates per page (and avoid bloating every HTML response). Pick one delivery channel per page to keep things consistent.

Does hreflang work for region-only variants like en-US vs en-CA?

Yes, this is the primary use case for regional codes. The format is language-region where region uses ISO 3166-1 alpha-2 (en-US, en-GB, en-AU, en-CA). Google will show the right variant based on user location and browser language.

Can I use hreflang across subdomains or different domains?

Yes. hreflang URLs can point to subdomains (es.example.com), subdirectories (example.com/es/), or entirely different domains (example.es). All three are equally valid as long as you reference the full canonical URL.

Do I need hreflang if I only publish in one language?

No. Hreflang is only meaningful for content that exists in multiple languages or regional variants. Single-language sites don't need it.

Is the generator safe to use with proprietary or staging URLs?

Yes. Everything runs in your browser. No URLs, locales, or generated tags are sent to any server — there's no upload, no logging, no tracking.

Web y SEOParte de Herramientas web y SEO →

Generador de Hreflang

Genera etiquetas hreflang para URLs de idiomas alternativos e incluye la salida x-default.

Tus datos se quedan en tu dispositivoSin subida, sin servidorFunciona sin conexión

Por qué usar esta herramienta

Construye etiquetas de idioma alternativo a partir de pares de locale y URL sin escribir cada etiqueta manualmente.

Úsalo cuando tengas URLs específicas por idioma y necesites el bloque hreflang para el head de la página.

Mantiene los pares de locale y la salida x-default en un mismo lugar.

Cómo usarla

01Establece el locale predeterminado.

02Introduce un locale y URL por fila.

03Copia las etiquetas hreflang generadas.

Revisiones rápidas antes de copiar

Confirma que el formato de entrada es el que esperabas.

Revisa el resultado antes de usarlo en un documento, URL, configuración o mensaje.

Copia solo el resultado que necesitas.

Preguntas frecuentes

¿Necesito hreflang si solo publico en un idioma?

No. Hreflang solo es útil cuando el mismo contenido existe en múltiples idiomas o regiones.

¿Qué es el hreflang x-default?

Marca la versión predeterminada que se muestra cuando ninguna página específica de locale coincide con la región del usuario.

¿Puedo añadir más locales después?

Sí. Las filas iniciales son solo una base; se pueden agregar más filas cuando sea necesario.

Herramientas relacionadas

Verificador de Etiqueta Canonical

Compara la URL de la página y la URL canonical para detectar canonicals propios, de dominio cruzado o incorrectos.

Generador de Lista de URLs para Sitemap

Limpia, recorta y deduplica URLs de páginas antes de construir un archivo sitemap.

Espacio de Trabajo SEO Preflight

Ejecuta verificaciones de lanzamiento de página para título, descripción, canonical, robots, sitemap y hreflang en un solo espacio de trabajo.

Web y SEOParte de Herramientas web y SEO →

Generador de Hreflang

Genera etiquetas hreflang para URLs de idiomas alternativos e incluye la salida x-default.

Tus datos se quedan en tu dispositivoSin subida, sin servidorFunciona sin conexión

Modo

Formato de salida

Suelta un CSV aquí o haz clic para cargarDos columnas: locale,url

Idioma predeterminado

Idioma 1URL 1

Idioma 2URL 2

Etiquetas hreflang generadas

<link rel="alternate" hreflang="en" href="https://toolgrid.app/tools/url-parser" />
<link rel="alternate" hreflang="zh-CN" href="https://toolgrid.app/tools/url-parser?lang=zh-CN" />
<link rel="alternate" hreflang="x-default" href="https://toolgrid.app/tools/url-parser" />

Por qué usar esta herramienta

Construye etiquetas de idioma alternativo a partir de pares de locale y URL sin escribir cada etiqueta manualmente.

Úsalo cuando tengas URLs específicas por idioma y necesites el bloque hreflang para el head de la página.

Mantiene los pares de locale y la salida x-default en un mismo lugar.

Cómo usarla

01Establece el locale predeterminado.

02Introduce un locale y URL por fila.

03Copia las etiquetas hreflang generadas.

Revisiones rápidas antes de copiar

Confirma que el formato de entrada es el que esperabas.

Revisa el resultado antes de usarlo en un documento, URL, configuración o mensaje.

Copia solo el resultado que necesitas.

Preguntas frecuentes

¿Necesito hreflang si solo publico en un idioma?

No. Hreflang solo es útil cuando el mismo contenido existe en múltiples idiomas o regiones.

¿Qué es el hreflang x-default?

Marca la versión predeterminada que se muestra cuando ninguna página específica de locale coincide con la región del usuario.

¿Puedo añadir más locales después?

Sí. Las filas iniciales son solo una base; se pueden agregar más filas cuando sea necesario.

Generador de Hreflang

Verificador de Etiqueta Canonical→

Generador de Lista de URLs para Sitemap→

Espacio de Trabajo SEO Preflight→

Generador de Hreflang

Verificador de Etiqueta Canonical→

Generador de Lista de URLs para Sitemap→

Espacio de Trabajo SEO Preflight→

Verificador de Etiqueta Canonical

Generador de Lista de URLs para Sitemap

Espacio de Trabajo SEO Preflight

Verificador de Etiqueta Canonical

Generador de Lista de URLs para Sitemap

Espacio de Trabajo SEO Preflight