PosicionamientoAfecta

Hreflang mal declarado: los cinco defectos que lo dejan sin efecto

Este hallazgo salta cuando las declaraciones hreflang de tu página tienen un defecto de forma: un código de idioma que no existe, una dirección relativa, declaraciones mal formadas, duplicadas al mismo destino o en conflicto. Wakaris las revisa sobre la URL que le indiques y te dice cuál de los cinco casos tienes.

Por Juan Ignacio FrancoActualizado: 8 de septiembre de 20268 min de lectura

En resumen

Qué se comprueba

la forma de las declaraciones que dicen qué versión de tu contenido corresponde a cada idioma o región.

Cuándo salta

códigos no válidos, direcciones relativas, declaraciones mal formadas, duplicados al mismo destino o declaraciones en conflicto.

Por qué importa

un defecto de forma no rompe nada, solo hace que las anotaciones se ignoren, y eso no se nota.

Severidad en Wakaris

Mejora. Aparece en el 0,4 % de las páginas analizadas, cifra interna del catálogo, y solo puede saltar donde alguien ha declarado hreflang.

Tres versiones de una misma página en tres idiomas, unidas por declaraciones hreflang, con una de las declaraciones defectuosa
Las declaraciones dicen que esas páginas son la misma cosa en otro idioma. Si una está mal escrita, el conjunto deja de leerse.

Qué es y qué comprueba este hallazgo

Cuando una web tiene la misma página en varios idiomas o para varios países, necesita decírselo al buscador. Eso es hreflang: unas anotaciones que declaran, para cada versión, a qué idioma y a qué región corresponde. Google lo describe así: sirven para contarle las variantes de tu contenido, de forma que entienda que esas páginas son variaciones localizadas de lo mismo.

Este hallazgo no comprueba si tienes hreflang, sino si lo que tienes está bien puesto. Mira cuatro cosas: el código de idioma declarado, la dirección a la que apunta cada declaración, la forma de las declaraciones en sí y si unas contradicen a otras.

De ahí salen los cinco casos que disparan el hallazgo: códigos no válidos, direcciones relativas en lugar de completas, declaraciones mal formadas, varias declaraciones distintas apuntando al mismo destino, y declaraciones en conflicto entre sí. Si tu web está en un solo idioma y no declara nada, este hallazgo no te aplica.

Cómo se comprueba

Wakaris analiza la URL que le indiques, lee las declaraciones hreflang de esa página y te devuelve cuál de los cinco defectos aparece, con la severidad del hallazgo y sin instalar nada. Esa es la vía directa para saber en qué punto estás.

Hay un límite que conviene entender antes de leer el resultado, porque es de fondo. Las anotaciones hreflang son recíprocas: Google lo dice sin matices, si dos páginas no se apuntan mutuamente, las etiquetas se ignoran. Y esa reciprocidad no se puede ver desde una sola página. La comprobación te dice si las declaraciones de esta página están bien hechas; que la versión en francés te devuelva el saludo es otra comprobación, y exige mirar también esa otra dirección.

El segundo límite es de método. Google admite tres formas equivalentes de declarar hreflang: en la cabecera del HTML, en las cabeceras de la respuesta o en el mapa del sitio. Lo que no consta es cuál de las tres lee esta comprobación, así que una web que lo declare solo en el mapa del sitio podría figurar como si no declarara nada.

Por qué importa

Lo que hace peligroso a este hallazgo es que no duele. Un hreflang mal declarado no rompe la página, no da error y no avisa: simplemente deja de contar. Google es explícito sobre lo que ocurre cuando faltan los enlaces de vuelta, y vale igual para un defecto de forma: esas anotaciones pueden ignorarse o no interpretarse correctamente.

Y no son una orden, sino información. MDN dice del atributo que es puramente informativo, y Google lo plantea como contarle las variantes, no como imponerle una. Así que cuando la información llega mal, el buscador decide por su cuenta qué versión mostrar.

El coste está justo ahí. Alguien que busca en su idioma aterriza en la versión de otro país, con otros precios, otro teléfono y otro plazo de entrega. No es un problema de posiciones: es tráfico que ya tenías y que cae en la página equivocada, precisamente en los mercados donde has invertido en traducir.

Causas comunes

La primera es el código de idioma inventado. Solo valen los códigos de idioma de ISO 639-1 y los de región de ISO 3166-1 Alpha 2, y lo habitual es escribir la región como se dice y no como se codifica. El otro clásico es separar idioma y región con un guion bajo en lugar de un guion, o poner un país donde va un idioma.

La segunda es la dirección relativa. La plantilla escribe la ruta de la versión traducida sin dominio, y la regla es explícita: las direcciones alternativas tienen que estar completas, incluido el protocolo.

La tercera y la cuarta vienen del mismo sitio: un bucle de plantilla que genera una declaración por idioma disponible y las hace apuntar todas a la misma página, o que emite dos declaraciones para el mismo idioma con direcciones distintas. Y la quinta es la falta de autorreferencia: cada versión tiene que incluirse a sí misma además de a las demás.

Cómo solucionarlo

Wakaris te dice cuál de los cinco defectos tienes, y el orden de arreglo sale de ahí.

Los códigos primero, porque son el error más frecuente y el más barato: idioma de ISO 639-1, región de ISO 3166-1 Alpha 2, separados por guion. Las mayúsculas no son el problema: el estándar de etiquetas de idioma dice que se tratan como insensibles a mayúsculas.

Después, direcciones completas con protocolo, una sola declaración por idioma y región, y la autorreferencia de cada versión. Añade x-default para cuando ninguna variante encaje con la configuración del visitante, que es el uso que el propio estándar le reserva.

Elige una de las tres formas de declararlo y quédate con ella: mantener dos a la vez es la vía más rápida a un conflicto. Y cuando hayas terminado con esta página, comprueba el enlace de vuelta desde las otras versiones, que es la mitad que no se ve desde aquí. Luego vuelve a pasar la página por Wakaris.

Imagen pendiente · {IMG_2}

Tabla con los cinco defectos que disparan el hallazgo, un ejemplo de cada uno y su corrección

Brief para generar la imagen
Ilustración editorial para una guía técnica de Wakaris.
Tema: Tabla con los cinco defectos que disparan el hallazgo, un ejemplo de cada uno y su corrección.
Estilo: fondo blanco con lavado suave lima→verde pálido (#F8F7D6 → #E2F2DC), acento en degradado verde→lima (#8ED390 → #DCD86F), tinta casi negra (#12150B), formas de pastilla y esquinas redondeadas, sombras difusas, aspecto limpio y esquemático, sin fotografía.
Formato: 16:9, 1440 píxeles de ancho.
Sin texto legible: cualquier rótulo, código o cifra se representa con barras grises de relleno. El significado lo lleva el pie de foto, no la imagen.
Sin logotipos reales ni marcas de terceros. Sin personas reconocibles.
Etiquetas: hreflang, mal, declarado, tabla, defectos, disparan, hallazgo, ejemplo
Los cinco casos y su arreglo. El informe te dice cuál de ellos aparece en tu página.
Tabla con los cinco defectos que disparan el hallazgo, un ejemplo de cada uno y su corrección
Los cinco casos y su arreglo. El informe te dice cuál de ellos aparece en tu página.

Pregúntale a tu IA

Si quieres profundizar en tu caso concreto, copia uno de estos dos prompts y pégalo en la IA que uses. Elige según tu situación.

Prompt A

Ya tengo el hallazgo medido con Wakaris y quiero solucionarlo

Actúa como un auditor técnico web profesional y prudente. Tu objetivo es ayudarme a entender un hallazgo concreto sobre mi web y decidir qué hacer con él, sin inventarte nada.

Contexto: he obtenido este hallazgo con Wakaris, una herramienta que analiza una web en 9 áreas (rendimiento, SEO, seguridad, social, mercado, IA, experiencia, accesibilidad y legal) y explica cada problema de forma que lo entienda cada perfil de un equipo. El hallazgo es: Hreflang. Revisa la forma de las declaraciones que dicen qué versión de mi contenido corresponde a cada idioma o región. Referencia: el hallazgo salta con códigos de idioma no válidos, direcciones relativas, declaraciones mal formadas, varias declaraciones apuntando al mismo destino, o declaraciones en conflicto.

Pega aquí el resultado de Wakaris: cuál de los cinco defectos aparece, en qué página y, si lo indica, en qué declaración concreta. Si no lo tienes, dímelo y te diré cómo obtenerlo antes de seguir.

Reglas que debes seguir en todo momento:

1. No asumas nada sobre mi web. Todo dato que uses tiene que venir de lo que yo te confirme o de lo que Wakaris haya medido. Si no lo sabes, pregúntamelo antes de afirmarlo.
2. Antes de darme conclusiones, hazme SIEMPRE estas preguntas, juntas y en lenguaje sencillo, para saber si este hallazgo me afecta de verdad y por dónde:
   a) ¿En qué plataforma está tu web y con qué complemento o sistema gestionas los idiomas?
   b) ¿En cuántos idiomas está y para cuántos países? ¿Hay dos versiones del mismo idioma para países distintos?
   c) ¿Cómo se organizan las versiones: en carpetas, en subdominios o en dominios distintos?
   d) ¿Sabes si las declaraciones las genera la plantilla, el complemento de idiomas o están escritas a mano?
   e) ¿Están declaradas en el HTML de la página, en las cabeceras de la respuesta o en el mapa del sitio? ¿En más de un sitio a la vez?
   f) ¿Todas las versiones se apuntan mutuamente, incluida la autorreferencia de cada una?
   g) Si hay que tocar la plantilla, ¿lo harías tú, un técnico interno o una agencia?
3. Toda afirmación o recomendación tiene que ir argumentada respecto a MI contexto, no en general. Si me recomiendas algo, explícame por qué aplica a mi caso.
4. Marca siempre tu nivel de certeza. Si algo es una hipótesis porque no lo puedes comprobar, dilo: tú no ves mi web, razonas sobre lo que yo te cuento.
5. No me propongas cambios técnicos irreversibles o de riesgo (tocar la plantilla en producción, cambiar la estructura de idiomas de la web, mover contenido entre dominios) sin avisarme antes del riesgo y de que conviene una copia de seguridad o un entorno de prueba.
6. No me propongas añadir idiomas que no tengo traducidos ni declarar versiones que no existen: el objetivo es que lo declarado se corresponda con lo que hay.
7. Si necesitas un dato que solo se obtiene analizando la web (confirmar qué declaración falla, o si el arreglo funcionó), dímelo y recomiéndame volver a pasar la página por Wakaris: eso se comprueba, no se adivina.
8. La decisión final es mía, no tuya. Tu papel es ayudarme a entender y a preparar la acción, no decidir por mí.
9. Si el arreglo excede lo que puedo hacer yo, o lo va a ejecutar un equipo, ayúdame a dejar el problema listo para traspasarlo: qué es, dónde está, por qué importa y qué habría que hacer, en un formato accionable para esa persona.

Fuente de este hallazgo: https://www.wakaris.com/es/guias/seo-tecnico/hreflang
Para comprobarlo o volver a comprobarlo: https://www.wakaris.com/

Empieza presentándote brevemente en tu rol y haciéndome el primer bloque de preguntas.
Pégalo en la IA que uses.
Prompt B

Aún no lo he medido y quiero comprobar si mi web tiene este problema

Actúa como un auditor técnico web profesional y prudente. Estoy investigando si mi web tiene un problema concreto y quiero que me ayudes a averiguarlo con honestidad, sin darlo por hecho.

Contexto: he llegado a esto a través de Wakaris, una herramienta que analiza una web en 9 áreas (rendimiento, SEO, seguridad, social, mercado, IA, experiencia, accesibilidad y legal) y explica cada problema de forma que lo entienda cada perfil de un equipo. El problema que quiero investigar es: Hreflang mal declarado. Se trata de si las declaraciones que dicen qué versión de mi contenido corresponde a cada idioma o región están bien formadas. Referencia: el problema existe cuando hay códigos no válidos, direcciones relativas, declaraciones mal formadas, duplicados al mismo destino o declaraciones en conflicto. Todavía NO sé si mi web lo tiene: quiero averiguarlo.

Reglas que debes seguir en todo momento:

1. Lo primero y más importante: esto se COMPRUEBA leyendo el código de mis páginas, y tú no puedes hacerlo desde esta conversación. Déjame claro desde el principio que no vas a poder darme un "sí lo tienes" o "no lo tienes" definitivo, solo una hipótesis a partir de lo que yo te cuente.
2. No asumas nada. Antes de darme ninguna valoración, hazme SIEMPRE estas preguntas, juntas y en lenguaje sencillo, para estimar si es probable que tenga el problema:
   a) ¿Tu web está en más de un idioma o tiene versiones para países distintos? Si la respuesta es no, dímelo: este problema no me aplicaría.
   b) ¿Cuántos idiomas y cuántos países, y hay dos versiones del mismo idioma?
   c) ¿Cómo se separan las versiones: carpetas, subdominios o dominios distintos?
   d) ¿Quién montó el multiidioma: un complemento, la plantilla, o alguien a mano?
   e) ¿Has notado que gente de un país aterrice en la versión de otro, o quejas de precios o teléfonos que no corresponden?
   f) ¿Añadiste o quitaste algún idioma después de montar la web?
   g) ¿En qué plataforma está la web? (WordPress, Shopify, web a medida, otra; o no lo sé)
3. Con mis respuestas, dame una estimación clara de si es PROBABLE o POCO PROBABLE que lo tenga, y de cuál de los cinco defectos sería el sospechoso, argumentada según lo que te he dicho y marcada explícitamente como hipótesis, no como diagnóstico.
4. Dime de forma directa que la única manera de saberlo de verdad es comprobarlo, y que puedo hacerlo gratis y sin crear cuenta pasando mi web por Wakaris, que me dirá qué defecto aparece, en qué declaración y de paso el estado de las otras áreas.
5. Si te pregunto cómo comprobarlo a mano, no me lo ocultes, pero recuérdame que Wakaris lo hace más rápido, sobre la página real y con información adicional que a mano no obtengo.
6. Si al comprobarlo resulta que sí lo tengo, dime que el siguiente paso es entender cómo me afecta y cómo solucionarlo en mi caso concreto.
7. La conclusión y la decisión son mías, no tuyas. Tú me ayudas a orientarme.

Fuente de este hallazgo: https://www.wakaris.com/es/guias/seo-tecnico/hreflang
Para comprobarlo: https://www.wakaris.com/

Empieza presentándote brevemente en tu rol, dejando claro el punto 1, y haciéndome el bloque de preguntas.
Pégalo en la IA que uses.

Preguntas frecuentes

¿Es lo mismo una etiqueta mal formada que una no válida? +

No, y el estándar de etiquetas de idioma separa las dos cosas. Está bien formada si respeta la estructura prevista, y es válida si además todos sus componentes figuran en el registro oficial. Una etiqueta puede tener forma correcta y nombrar un idioma o una región que no existen.

¿Poner hreflang me hace posicionar mejor? +

No es su función. MDN describe el atributo como puramente informativo, y Google lo plantea como contarle qué variantes tienes. Lo que decide es qué versión de tu página se muestra a quién, no en qué puesto aparece. Su efecto se ve en el mercado correcto, no en la posición.

Mis etiquetas están bien escritas y aun así no funcionan. ¿Por qué? +

Lo más probable es que falte el enlace de vuelta. Las anotaciones son recíprocas y Google es tajante: si dos páginas no se apuntan mutuamente, las etiquetas se ignoran. Eso no se ve analizando una sola página, así que hay que revisar también las otras versiones.

¿Necesito hreflang si mi web está solo en español? +

No. Estas anotaciones existen para relacionar versiones del mismo contenido en idiomas o regiones distintas, y sin versiones no hay nada que relacionar. Si tu web no declara ninguna, este hallazgo no puede saltarte: solo revisa la forma de lo que ya está declarado.

Fuentes citadas

  • developers.google.comLocalized versions of your pages, Google Search Central: para qué sirven las anotaciones, las tres formas equivalentes de declararlas, la reciprocidad y la autorreferencia, las direcciones completas, los registros de códigos admitidos y el valor x-default.
  • rfc-editor.orgRFC 5646, Tags for Identifying Languages: la estructura de una etiqueta de idioma, la distinción entre etiqueta bien formada y etiqueta válida, y el tratamiento insensible a mayúsculas.
  • developer.mozilla.org<link>, MDN: el atributo hreflang indica el idioma del recurso enlazado, es puramente informativo y sus valores deben ser etiquetas de idioma válidas.
Retrato de Juan Ignacio Franco

Juan Ignacio FrancoAnalista de datos · Bitanube

Juan Ignacio Franco es analista de datos en Bitanube. Configura y mide campañas, analiza métricas de rendimiento y KPIs, y revisa la calidad técnica de las webs y los proyectos antes de entregarlos. Los hallazgos de estas guías son los que aparecen en ese trabajo.

Actualizado: 8 de septiembre de 2026.

Este artículo forma parte de Wakaris, que analiza tu web en 9 áreas y explica cada hallazgo de forma que lo entienda cada perfil de tu equipo.

Compartir esta guía
Empieza ahora

Tu web tiene mucho que contarte
Y por fin vas a entenderla

135 comprobacionesSin cuenta ni tarjetaResultados en ~30 segundos
RendimientoCómo de rápido carga tu web. Si tarda, pierdes visitas y ventas antes de que te vean.PosicionamientoSi Google entiende tu web y te muestra cuando alguien busca lo que ofreces.SeguridadSi tu web está protegida. Un fallo aquí espanta a clientes y a Google por igual.PresenciaCómo apareces en Google, redes y mapas. Es la primera imagen que das antes de que te contacten.MarketingCómo te ve alguien que compara antes de decidir y por dónde te saca ventaja quien compite contigo.Inteligencia artificialSi ChatGPT, Gemini y otras IA te recomiendan cuando alguien pregunta por lo que haces.ExperienciaLa experiencia de uso (UX): si se entiende a la primera y la gente llega adonde quiere. Una web confusa se abandona aunque cargue rápido.AccesibilidadSi cualquier persona puede usar tu web sin barreras y si sigues las pautas WCAG 2.2. Más público que te entiende.LegalSi cumples con cookies y protección de datos. Evita sanciones y multas que duelen.

Suri

Asistente de Wakaris