Generador de etiquetas hreflang

El propósito de las etiquetas hreflang en SEO internacional

Las etiquetas rel="alternate" hreflang son elementos de marcado HTML fundamentales para los propietarios de sitios web, desarrolladores y profesionales de SEO que gestionan portales multilingües o multi-regionales. Cuando un sitio web ofrece el mismo contenido adaptado a diferentes idiomas o áreas geográficas, los motores de búsqueda necesitan entender la relación exacta entre estas páginas.

El uso correcto de estas etiquetas permite que los motores de búsqueda identifiquen qué versión de una URL deben mostrar a un usuario en función de su idioma de preferencia y su ubicación geográfica. Esto evita problemas de indexación y asegura que un visitante que busca desde una región específica sea dirigido de forma automática a la variante de la página diseñada para su mercado.

Estructura y sintaxis de los atributos hreflang

Una etiqueta hreflang válida se compone de una relación de alternancia, una URL de destino absoluta y un atributo que especifica el idioma y, de manera opcional, la región o la escritura del texto. La estructura estándar sigue este formato: <link rel="alternate" hreflang="código" href="url" />.

Para que los motores de búsqueda procesen esta información, los códigos utilizados deben seguir estrictamente las convenciones internacionales de estandarización:

• Idioma: Se debe emplear un código de dos letras que cumpla con la norma ISO 639-1.
• Escritura: En idiomas que admiten diferentes alfabetos, se puede añadir un subtag de escritura según la norma ISO 15924 (por ejemplo, Hant para caracteres tradicionales o Hans para caracteres simplificados).
• Región: Se puede especificar un código de país o región de dos letras bajo la norma ISO 3166-1 Alpha-2.

El generador valida de forma automática estas combinaciones. Por ejemplo, admite códigos simples como en, combinaciones con escrituras como zh-Hant o zh-CN, y especificaciones completas de idioma, escritura y región como zh-Hans-US. Durante el procesamiento, la herramienta normaliza las mayúsculas y minúsculas (convirtiendo, por ejemplo, una entrada como EN-us en en-US) y escapa los parámetros de consulta presentes en las URL.

El papel de la etiqueta x-default

La directiva x-default es un valor especial del atributo hreflang que señala la página de reserva o fallback del sitio web. Se utiliza para indicar a los motores de búsqueda qué URL deben mostrar a aquellos usuarios cuyo idioma o ubicación geográfica no coincida con ninguna de las versiones específicas declaradas en el resto de las etiquetas.

Esta URL de reserva suele apuntar a una página de inicio global, a un selector de idioma interactivo o a la versión lingüística principal del sitio web. Incluir una etiqueta x-default garantiza que siempre exista una opción predeterminada para el tráfico internacional que no encaja en las segmentaciones locales.

Reglas de validación y límites del generador

Para garantizar la creación de un marcado libre de errores, el generador aplica un conjunto estricto de reglas de validación sobre los datos introducidos:

• Límite de versiones: El editor admite un máximo de hasta 100 versiones de idioma de forma simultánea.
• Longitud de las URL: Cada dirección web introducida debe ser inferior a los 2.048 caracteres.
• Protocolo obligatorio: Todas las URL, tanto las de las versiones individuales como la de x-default, deben ser direcciones completas que comiencen con http:// o https://.
• Códigos no admitidos: No se permiten códigos regionales que no pertenezcan a la norma ISO 3166-1 Alpha-2 (como es-419, que es rechazado) ni códigos de idioma o escritura desconocidos.
• Generación condicional: Las etiquetas solo se generan si todos los campos superan la validación. Si existe algún error en las filas, el resultado permanecerá vacío para evitar la exportación de código defectuoso.

Errores comunes en la implementación de hreflang

La configuración manual de estas etiquetas suele ser propensa a fallos que invalidan el marcado ante los motores de búsqueda. Entre los problemas más habituales se encuentran:

1. Falta de reciprocidad: Para que las etiquetas funcionen, cada página debe enlazarse a sí misma y a todas las demás versiones de la red. Si la página A apunta a la página B, la página B debe incluir obligatoriamente una etiqueta de vuelta hacia la página A.
2. Códigos ISO incorrectos: Utilizar códigos de país para definir idiomas (o viceversa) o emplear abreviaturas no estandarizadas.
3. URL relativas o rotas: Las directivas hreflang requieren URL absolutas con su protocolo correspondiente.
4. Duplicación de códigos: Asignar el mismo código de idioma o región a dos URL diferentes dentro del mismo bloque de alternativas.

Mensajes de error de la interfaz

Si alguno de los datos introducidos no cumple con los requisitos técnicos, la herramienta mostrará alguno de los siguientes mensajes específicos para guiar la corrección:

• Añade al menos dos versiones de idioma.
• La versión {index} necesita un código de idioma o de idioma y región.
• La versión {index} necesita una URL completa.
• La versión {index} debe usar un código de idioma de dos letras y, si procede, un código de escritura ISO 15924 y/o un código regional de dos letras.
• La versión {index} usa {code}, que no es un código de idioma ISO 639-1.
• La versión {index} usa {code}, que no es un código regional ISO 3166-1 Alpha-2.
• La versión {index} usa {code}, que no es un código de escritura ISO 15924 válido.
• La versión {index} repite el código hreflang {locale}.
• La versión {index} necesita una URL completa con http:// o https://.
• La URL de la versión {index} debe tener menos de 2.048 caracteres.
• Añade la URL que debe usar x-default.
• La URL de x-default debe ser una dirección completa con http:// o https://.
• La URL de x-default debe tener menos de 2.048 caracteres.
• Este editor admite hasta {max} versiones de idioma a la vez.

Privacidad de los datos

El procesamiento de la información se realiza de manera local. Tus URL se quedan en el navegador y no se envía nada a BroBroGo, lo que garantiza que los datos de estructura de tu sitio web no se transmitan ni se almacenen en servidores externos durante el proceso de generación.

Preguntas frecuentes

¿Qué códigos hreflang acepta el generador?
Usa un código de idioma ISO 639-1 de dos letras y, si lo necesitas, un código de escritura ISO 15924 y/o un código regional ISO 3166-1 de dos letras: en, zh-Hant, zh-CN o zh-Hans-US. El resultado corrige las mayúsculas y minúsculas.

¿Dónde coloco las etiquetas generadas?
Pon el mismo bloque completo, sin modificar, dentro del <head> de cada versión. Cada página debe enlazarse a sí misma y a todas las demás.

¿A qué página debe apuntar x-default?
Elige la página que recibirá a quien no tenga una coincidencia exacta de idioma o región. Puede ser un selector de idioma, la portada global o tu versión principal.