# Hreflang / i18n

_Fuente: https://seomatrix.ai/es/tools/hreflang/_

---

## Qué hace

Hreflang es una anotación HTML que indica a los motores de búsqueda qué versión lingüística y regional de una página mostrar a cada usuario; este verificador comprueba que tus anotaciones sean completas y coherentes en todas las versiones. Detecta tres fallos que rompen la indexación de un sitio multilingüe —la falta de autorreferencia, las entradas duplicadas o en conflicto y los enlaces no recíprocos (unidireccionales)— además de la ausencia de x-default, una salvaguarda opcional pero recomendable. Un hreflang roto hace que el buscador muestre la versión lingüística equivocada o ignore por completo tus alternativas, tanto a los usuarios como a los motores de IA que citan por URL.

## Qué revisa

- **Autorreferencia** — Cada página de un conjunto hreflang debe incluirse a sí misma entre las alternativas; sin esa etiqueta autorreferencial el buscador considera la anotación no verificada y puede descartar todo el grupo.
- **x-default** — El valor x-default marca la página de reserva que se muestra cuando el idioma o la región del usuario no coincide con ninguna alternativa; es opcional pero evita que esos visitantes lleguen a la localización equivocada.
- **Reciprocidad** — Los enlaces hreflang deben ser mutuos: si la página A apunta a la B, la B debe apuntar a la A; los enlaces unidireccionales se tratan como error y se descartan.
- **Entradas duplicadas** — Dos etiquetas hreflang con el mismo código de idioma-región pero URLs distintas crean un conflicto que el buscador no puede resolver, por lo que no confía en ninguna.
- **Códigos de idioma y región** — Los valores deben ser códigos ISO 639-1 válidos, opcionalmente con una región ISO 3166-1 (por ejemplo, es, en-GB); un código erróneo o inexistente se ignora en silencio.
- **Conjunto completo de alternativas** — Cada página debe enumerar el conjunto completo de todas las versiones lingüísticas; si falta una, se rompe el vínculo entre localizaciones y la cobertura queda incompleta.

## Cómo usarla

1. Pega la URL de una versión lingüística de tu página en el verificador.
2. Revisa los problemas señalados —autorreferencia ausente, falta de x-default, duplicados o enlaces unidireccionales— agrupados por localización.
3. Corrige las etiquetas en el head de cada página (o en el sitemap / cabecera HTTP) para que todas las versiones enumeren el conjunto recíproco completo, y vuelve a comprobar.

## Preguntas

### ¿Qué es hreflang y cuándo lo necesito?

Hreflang es una anotación que indica a los buscadores el idioma y la región a los que se dirige una página. Lo necesitas siempre que el mismo contenido exista en más de un idioma o en variantes regionales, para que el buscador sirva la versión correcta a cada usuario.

### ¿Hreflang debe ser recíproco?

Sí. Cada alternativa que declares debe declararte de vuelta; un hreflang unidireccional Google lo considera un error y lo ignora.

### ¿Para qué sirve x-default?

x-default designa la página de reserva para los usuarios cuyo idioma o región no coincide con ninguna alternativa. Es opcional pero recomendable, y suele apuntar a un selector de idioma o a la página de inicio en el idioma predeterminado.

### ¿Dónde deben ir las etiquetas hreflang?

En el head de cada página, en un sitemap XML o en la cabecera HTTP. Elige un solo método y aplícalo de forma coherente, ya que mezclar métodos en la misma página puede causar conflictos.

