# Hreflang: cómo conectar las versiones de idioma

> Conecta páginas equivalentes en español e inglés, comprueba la reciprocidad y evita confundir idioma, país y URL canónica.


**Hreflang indica a Google qué URLs son versiones de una página para diferentes idiomas o regiones.** Es útil cuando un taller tiene una ficha en español y otra en inglés: permite declarar su relación aunque sus direcciones tengan palabras distintas. Las traducciones deben existir; la anotación no traduce el contenido.

## Una pareja ES/EN con slugs distintos

Supongamos que estas dos rutas ilustrativas contienen la misma oferta traducida:

- `https://www.example.com/es/taller-ceramica/`
- `https://www.example.com/en/pottery-workshop/`

En el `head` de **ambas páginas**, el conjunto mínimo del ejemplo sería el mismo:

```html
<link rel="alternate" hreflang="es"
  href="https://www.example.com/es/taller-ceramica/" />
<link rel="alternate" hreflang="en"
  href="https://www.example.com/en/pottery-workshop/" />
```

La página española se incluye a sí misma y señala a la inglesa. La inglesa hace lo mismo. Si solo se declara la relación desde un lado, falta reciprocidad. Comprueba las dos respuestas publicadas, incluso si el CMS parece generar ambas desde la misma plantilla.

Google admite [anotaciones mediante HTML, cabeceras HTTP o sitemap](https://developers.google.com/search/docs/specialty/international/localized-versions). Escoge un método que puedas mantener. Implementar los tres a la vez añade puntos donde las versiones pueden descoordinarse.

## Idioma y país responden preguntas diferentes

`es` identifica español sin limitarlo a un país. `es-CL` añade una región para una versión dirigida a Chile. No introduzcas una región solo porque el negocio está allí: primero decide si existe una página regional distinta que deba ofrecerse.

Para inglés del Reino Unido, el código regional es `en-GB`. `en-UK` no es la combinación admitida por Google. Un país aislado tampoco sustituye al idioma. Si tus dos páginas sirven a cualquier lector en español o inglés, el ejemplo con `es` y `en` evita inventar variantes regionales que no existen.

`x-default` puede señalar una página de selección o una alternativa para idiomas no especificados. Es opcional y necesita un destino apropiado. No añadas una portada como equivalente de cada artículo solo para rellenar ese valor.

## Hreflang y canonical deben contar una historia coherente

La [URL canónica](/es/guides/url-canonica/) declara una preferencia entre contenido duplicado o muy parecido. Hreflang conecta versiones de idioma o región. Si el cuerpo está completamente traducido, no envíes automáticamente la canónica española a la inglesa por considerarla la «principal» del sitio.

En esta pareja hipotética, cada traducción puede tener una canónica hacia su propia URL, y ambas comparten el conjunto de alternates. Si una de esas direcciones redirige o se excluye con `noindex`, conviene resolver esa incoherencia antes de esperar que funcione como versión de búsqueda.

## Revisión antes de darla por configurada

Abre cada destino y confirma que corresponde al mismo taller. Una traducción de la portada no es la alternativa de una ficha específica. Revisa las URLs completas, los códigos y los enlaces de vuelta. Después comprueba que el selector visible de idioma lleva a la contraparte correcta.

Google recomienda [URLs separadas y enlaces para cambiar de idioma](https://developers.google.com/search/docs/specialty/international/managing-multi-regional-sites). Un cambio que depende solo de cookies dificulta compartir y revisar cada versión. Una redirección automática según ubicación también puede impedir que alguien abra la que necesita.

Conserva un registro de las parejas cuando publiques o retires traducciones. Si eliminas una versión, actualiza las anotaciones de las demás. La comprobación útil es mantener destinos equivalentes y accesibles; ver una etiqueta en el HTML, por sí sola, no garantiza qué versión mostrará Google en cada búsqueda.

## Planifica el próximo post en HeyMark.

Guarda la idea, revisa el texto con tu equipo y mira cómo le fue después en las cuentas que conectaste.

[Empezar gratis](https://app.heymark.ai) · [Ver cómo funciona](https://heymark.ai/es/#product)

## Recursos para desarrolladores y agentes

- [Documentación MCP de HeyMark](https://heymark.ai/es/mcp/)
- [llms.txt](https://heymark.ai/llms.txt)
- [Contenido completo del sitio para modelos de lenguaje](https://heymark.ai/llms-full.txt)
- Endpoint del protocolo MCP: `POST https://mcp.heymark.ai`
- Metadatos OAuth del recurso protegido: [/.well-known/oauth-protected-resource](https://mcp.heymark.ai/.well-known/oauth-protected-resource)
- MCP server card: [/server-card](https://mcp.heymark.ai/server-card)
