# Hreflang Manager: etiquetas hreflang multilingües y multitienda

> Presentación Hreflang Manager escribe las etiquetas de sus páginas para indicar a Google las versiones lingüísticas y regionales de una misma página. Escribe un único conjunto por página, solo en…

- Página: <https://www.datafirefly.com/es/documentation/datafireflyhreflang/>
- Idioma: es
- Actualizado el: 2026-11-14
- Otros idiomas: [fr](https://www.datafirefly.com/documentation/datafireflyhreflang/index.md), [en](https://www.datafirefly.com/en/documentation/datafireflyhreflang/index.md), [it](https://www.datafirefly.com/it/documentation/datafireflyhreflang/index.md), [nl](https://www.datafirefly.com/nl/documentation/datafireflyhreflang/index.md), [de](https://www.datafirefly.com/de/documentation/datafireflyhreflang/index.md), [pl](https://www.datafirefly.com/pl/documentation/datafireflyhreflang/index.md), [pt](https://www.datafirefly.com/pt/documentation/datafireflyhreflang/index.md)
- Índice: <https://www.datafirefly.com/es/documentation/llms.txt>

## Presentación

Hreflang Manager escribe las etiquetas `` de sus páginas para indicar a Google las versiones lingüísticas y regionales de una misma página. Escribe un único conjunto por página, solo en las páginas canónicas e indexables, y solo hacia las versiones que existen realmente.

Compatible con PrestaShop 1.7.8 a 9.x, tienda única y multitienda (uno o varios dominios). La versión 2.0.0 no contiene ningún override y no modifica ningún archivo del tema.

![Resumen de Hreflang Manager: puntuación, versiones activas y detección de conflictos (tema, SEO, sitemaps, override)](https://www.datafirefly.com/wp-content/uploads/2026/11/resumen-conflictos-datafireflyhreflang-es.webp)

Resumen de Hreflang Manager

## Novedades de la versión 2.0

- **Sin override**: el módulo funciona con hooks. El override de FrontController de la 1.0.0 se retira al actualizar.
- **Un único conjunto de etiquetas**: escrito en la variable del tema o mediante el hook displayHeader, con una protección que retira los duplicados.
- **Versiones comprobadas**: nada hacia un producto inactivo, sin traducir o ausente de una tienda; nada en las 404, páginas noindex, listados filtrados ni combinaciones.
- **Back office rediseñado**: asistente de configuración, mapa idioma × país → tienda, vista previa de las etiquetas, auditoría con puntuación, detección de conflictos, modo de prueba.
- Sitemap XML hreflang opcional, caché por página, compatibilidad con PrestaShop 1.7.8 e interfaz en 8 idiomas.

## Instalación y actualización

1. En **Módulos > Gestor de módulos**, haga clic en **Subir un módulo** y envíe el archivo ZIP.
2. El módulo se abre en **Parámetros de la tienda > Tráfico & SEO > Hreflang Manager**.
3. Mientras no haya ninguna versión configurada, no cambia nada en sus páginas. Inicie el **Asistente de configuración**.

La actualización desde la 1.0.0 conserva sus versiones y sus grupos. Los valores mal escritos se corrigen cuando la corrección es segura (`en_UK` pasa a `en-GB`, `fr_BE` pasa a `fr-BE`), se mantiene un solo x-default por grupo, el antiguo override se retira mediante el procedimiento de PrestaShop y el menú pasa a Tráfico & SEO. Se muestra un informe en la vista general.

En multitienda, instale el módulo en el contexto «Todas las tiendas» y compruebe que está activado en cada tienda de un grupo: de lo contrario, sus páginas no remiten a las demás versiones y Google ignora los pares. El detector de conflictos lo señala.

## Asistente de configuración

El asistente lee sus tiendas, sus dominios (HTTP o HTTPS), su país y sus idiomas activos, y propone un valor hreflang para cada par tienda e idioma:

- un idioma vendido en una sola tienda recibe solo el idioma (`fr`): se dirige a todos los francófonos;
- un idioma vendido en varias tiendas recibe el país de cada tienda (`fr-FR`, `fr-BE`) para que Google muestre la tienda adecuada;
- el x-default propuesto es el idioma principal de la tienda predeterminada.

Los valores se comprueban durante la introducción. Nada cambia en sus páginas antes de guardar.

![Asistente de configuración: tiendas, dominios e idiomas detectados, valores hreflang y x-default propuestos](https://www.datafirefly.com/wp-content/uploads/2026/11/asistente-configuracion-datafireflyhreflang-es.webp)

Asistente de configuración

## Versiones, grupos y mapa

Cada fila es una versión: una tienda, un idioma, un valor hreflang, un origen público opcional (si la tienda se sirve bajo otro dominio), un interruptor de activación y la elección del x-default. Una sola versión x-default por grupo.

El **mapa idioma × país → tienda** muestra qué tienda atiende a qué mercado. Las versiones en gris no se imprimen (inactivas o con el idioma desactivado en la tienda).

Los **grupos** vinculan tiendas que apuntan unas a otras. El contenido se empareja por id (catálogo compartido) o únicamente mediante **mapeo manual** (catálogos separados). El mapeo vincula dos ids de un producto, una categoría, una página CMS, una marca o un proveedor; funciona en ambos sentidos y se mantiene coherente en todo el grupo.

![Versiones y mapa idioma × país → tienda, con validación de los códigos hreflang al escribir](https://www.datafirefly.com/wp-content/uploads/2026/11/versiones-mapa-idiomas-paises-datafireflyhreflang-es.webp)

Versiones y mapa idioma × país → tienda, con validación de los códigos hreflang al escribir

## Reglas aplicadas

El módulo sigue las directrices de Google Search Central sobre las versiones localizadas:

- **URL absolutas** con el protocolo y el dominio de cada tienda; espacios y caracteres no permitidos codificados.
- **Autorreferencia** y **enlaces de retorno**: cada versión enumera todas las demás y a sí misma, con el mismo conjunto en todas las versiones.
- **Códigos válidos**: idioma ISO 639-1, país ISO 3166-1 alfa-2 opcional, escritura ISO 15924 opcional. `en-UK`, los guiones bajos, un país solo o `es-419` se rechazan con una sugerencia.
- **Solo versiones existentes**: producto activo y visible, categoría activa y accesible para los visitantes, página CMS activa e indexable, marca o proveedor activo, traducidos al idioma de destino.
- **Solo páginas canónicas e indexables**: ninguna etiqueta en las 404, páginas noindex, listados filtrados u ordenados, URL de combinación, carrito, cuenta y búsqueda, ni cuando la etiqueta canonical designa otra dirección.
- **Paginación**: la página 2 de una categoría apunta a la página 2 de las demás versiones (configurable).

## Vista previa de las etiquetas

Introduzca una URL de su tienda o elija un ejemplo (inicio, producto, categoría, página 2, página CMS). El módulo lee la página desde el servidor y muestra el diagnóstico (página canónica, noindex, versión ausente…), cada etiqueta con su control y, en paralelo, el head esperado y el head realmente impreso. Solo se pueden leer los dominios de su instalación.

![Vista previa de las etiquetas de una página de producto: etiquetas esperadas y mostradas, cada alternativa comprobada](https://www.datafirefly.com/wp-content/uploads/2026/11/vista-previa-etiquetas-datafireflyhreflang-es.webp)

Vista previa de las etiquetas de una página de producto

![Extracto del código fuente de la sección head: etiquetas hreflang esperadas y las que muestra la página](https://www.datafirefly.com/wp-content/uploads/2026/11/codigo-fuente-head-datafireflyhreflang-es.webp)

Extracto del código fuente de la sección head

## Auditoría

La auditoría lee una muestra de páginas de sus propios dominios (inicio, productos, categorías con página 2, páginas CMS, marcas, proveedores, otras páginas), cada una en todas sus versiones, y comprueba: respuesta 200, indexable, etiqueta canonical, valores, URL absolutas, autorreferencia, enlaces de retorno, duplicados, x-default y un único conjunto por página. Muestra una puntuación, los errores y advertencias agrupados por regla con la corrección necesaria, el historial de auditorías y una exportación CSV.

Ejecutada con el módulo en «Desactivado», la auditoría evalúa las etiquetas nativas de PrestaShop: la captura siguiente muestra este resultado en una tienda de demostración (enlaces de retorno ausentes en las páginas 2, x-default ausente).

![Auditoría hreflang de las etiquetas nativas de PrestaShop: puntuación, errores, avisos y correcciones propuestas](https://www.datafirefly.com/wp-content/uploads/2026/11/auditoria-puntuacion-errores-datafireflyhreflang-es.webp)

Auditoría hreflang de las etiquetas nativas de PrestaShop

La auditoría no llama a ningún servicio externo y solo lee las direcciones declaradas en sus tiendas. Si el servidor no puede acceder a su propio dominio (Docker, NAT, DNS local), la petición pasa por la interfaz local del servidor con el mismo nombre de host.

## Conflictos y otras fuentes

La vista general enumera lo que puede generar etiquetas hreflang además del módulo, sin modificar nunca sus ajustes:

- el **tema** (Classic, Hummingbird y la mayoría de los temas imprimen `$urls.alternative_langs`);
- **DataFirefly All in One SEO** si su opción «Gestionar hreflang» está activa: la protección mantiene un único conjunto y un botón ejecuta Hreflang Manager en último lugar;
- los sitemaps de **DataFirefly Sitemap** o de la suite SEO que contienen alternativas;
- los demás módulos que contienen código hreflang, el antiguo override de la 1.0.0, un módulo desactivado en una tienda del grupo, las tiendas servidas en HTTP.

El botón **Comprobar las páginas de inicio ahora** lee la página de inicio de cada tienda como un visitante y cuenta las etiquetas y los duplicados.

## Ajustes

- **Estado**: en línea, modo de prueba (visitantes y motores conservan las etiquetas originales; solo la vista previa y la auditoría ven las nuevas) o desactivado.
- **Dónde imprimir las etiquetas**: automático (variable del tema si el tema la imprime; si no, hook displayHeader), variable del tema o hook.
- **Protección contra duplicados** y **retirada de las etiquetas de PrestaShop** allí donde el módulo no las imprime (404, noindex, listados filtrados…).
- **Paginación**, **respeto de la etiqueta canonical**, otras páginas con versiones (más vendidos, novedades, promociones, contacto, tiendas físicas, listados de marcas y de proveedores) y páginas de módulos autorizadas (module/controller).
- **Sitemap XML hreflang**: opcional, uno por tienda, en la dirección `/module/datafireflyhreflang/sitemap`. Cada dirección enumera todas sus versiones con `xhtml:link`, incluida ella misma. Declárelo usted mismo en Google Search Console o en robots.txt.
- **Caché**: las alternativas de una página se calculan una vez y después se leen en una sola consulta; se recalculan cuando se guarda un producto, una categoría, una página CMS, una marca o un proveedor, y por completo cuando cambia una versión, un grupo, un idioma o una tienda.

![Ajustes: salida única, protección contra duplicados, paginación, sitemap XML hreflang y caché](https://www.datafirefly.com/wp-content/uploads/2026/11/ajustes-sitemap-cache-datafireflyhreflang-es.webp)

Ajustes

Si DataFirefly Sitemap o la suite SEO también incluyen hreflang en su sitemap, declare a Google solo uno de esos sitemaps, o compruebe que indican lo mismo.

## Seguridad y permisos

- Cada modificación requiere el permiso «Modificar» en la pestaña Hreflang Manager y el token de seguridad del back office; un perfil de solo lectura puede consultar, previsualizar y exportar.
- La vista previa y la auditoría rechazan cualquier dirección fuera de los dominios de la tienda (sin acceso a URL arbitrarias).
- Las URL impresas en el head se escapan; la exportación CSV neutraliza las celdas que empiezan por `=`, `+`, `-` o `@`.

## Desinstalación

La desinstalación elimina las 6 tablas del módulo (versiones, grupos, tiendas de los grupos, mapeo, caché, auditorías), sus ajustes y su pestaña. No hay que limpiar ningún archivo del tema ni ningún override.

## Solución de problemas

### Ninguna etiqueta en una página

Abra la vista previa en esa URL: el diagnóstico indica el motivo (página noindex, filtrada, de combinación, canonical hacia otra dirección, versión única, idioma sin versión, modo de prueba…).

### Etiquetas duplicadas

Active la protección contra duplicados y consulte «Conflictos y otras fuentes»: un módulo o el tema imprime sus propias etiquetas.

### Enlaces de retorno ausentes en la auditoría

Una versión está inactiva en un solo lado, el módulo está desactivado en una tienda del grupo o una caché de página completa sirve una página antigua. Vacíe la caché del módulo (Ajustes) y la de la tienda.
