---
title: "Hreflang sur Shopify : vérifier ce que Markets génère — Lyvora"
description: "Hreflang sur Shopify : lire les balises que Markets publie, contrôler leurs liens réciproques avec un script, puis corriger langues et marchés."
url: "https://www.lyvora.agency/blog/academie/hreflang-shopify"
lang: "fr-FR"
---

[Académie · SEO technique](https://www.lyvora.agency/blog/academie) 5 min de lecturePublié le 4 novembre 2026

# Hreflang sur Shopify : vérifier ce que Markets génère

Hreflang sur Shopify : lire les balises que Markets publie, contrôler leurs liens réciproques avec un script, puis corriger langues et marchés.

**Niveau**

Intermédiaire

**Durée**

30 min

**Prérequis**

au moins deux marchés ou deux langues publiés dans Shopify Markets

**Outils**

la console du navigateur, [Node.js](https://nodejs.org/) 18 ou plus, [la documentation Google sur les versions localisées](https://developers.google.com/search/docs/specialty/international/localized-versions)

[**Ylan Colson**Fondateur de Lyvora](https://www.lyvora.agency/agence)

[Partager sur LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fwww.lyvora.agency%2Fblog%2Facademie%2Fhreflang-shopify) [Partager sur X](https://x.com/intent/post?url=https%3A%2F%2Fwww.lyvora.agency%2Fblog%2Facademie%2Fhreflang-shopify&text=Hreflang+sur+Shopify%C2%A0%3A+v%C3%A9rifier+ce+que+Markets+g%C3%A9n%C3%A8re)

**Sommaire5 parties**

1. Étape 1 — Lister les balises hreflang d'une page
2. Étape 2 — Contrôler la réciprocité des balises hreflang
3. Étape 3 — Corriger les écarts dans Markets
4. Étape 4 — Suivre les versions dans la Search Console
5. Questions fréquentes

## L'essentiel

- Shopify Markets écrit seul les balises hreflang de chaque domaine ou sous-dossier : on ne les code pas, on les contrôle.
- Chaque version doit citer toutes les autres et se citer elle-même, sinon Google ignore la paire.
- Le script de l'étape 2 suit chaque lien et signale les retours manquants, les redirections et les codes mal formés.
- Presque toutes les anomalies se corrigent dans les réglages de Markets, pas dans le thème.

Résumer avec [ChatGPT](https://chatgpt.com/?q=R%C3%A9sume+cet+article+%3A+https%3A%2F%2Fwww.lyvora.agency%2Fblog%2Facademie%2Fhreflang-shopify) [Claude](https://claude.ai/new?q=R%C3%A9sume+cet+article+%3A+https%3A%2F%2Fwww.lyvora.agency%2Fblog%2Facademie%2Fhreflang-shopify) [Perplexity](https://www.perplexity.ai/search?q=R%C3%A9sume+cet+article+%3A+https%3A%2F%2Fwww.lyvora.agency%2Fblog%2Facademie%2Fhreflang-shopify)

Les balises hreflang disent à Google quelle version d'une page montrer selon la langue et le pays du visiteur. Sur Shopify, Markets les génère automatiquement pour chaque domaine ou sous-dossier international ([aide Shopify, « Markets et SEO »](https://help.shopify.com/fr/manual/markets/seo), consultée le 7 novembre 2026) : votre travail consiste à vérifier qu'elles sont complètes et réciproques. La stratégie internationale elle-même, domaines, devises et traductions, est traitée dans le guide [Shopify Markets : vendre à l'international](https://www.lyvora.agency/blog/guides/shopify-markets-vente-internationale).

_Code vérifié le 7 novembre 2026 : scripts contrôlés avec node --check, script Node lancé sur une boutique Shopify en ligne à plusieurs domaines. À tester sur votre boutique avant de corriger._

## Étape 1 : Lister les balises hreflang d'une page

Ouvrez une fiche produit en ligne, puis la console du navigateur (F12, onglet Console), et collez :

JavaScript

```
console.table(
  [...document.querySelectorAll('link[rel="alternate"][hreflang]')]
    .map((l) => ({ hreflang: l.hreflang, href: l.href }))
);
```

Le tableau liste une ligne par version : le code de langue, éventuellement suivi du pays, puis l'adresse. Shopify ajoute aussi une ligne `x-default`, qui désigne la version de repli pour les visiteurs qu'aucune autre ne couvre.

![Trois versions d'une fiche produit Shopify, française, britannique et allemande : chaque page porte quatre balises hreflang qui citent les deux autres, elle-même et la version x-default.](https://www.lyvora.agency/media/site/95f83928-782b-4f56-860c-5dfbb7c87b89/hreflang-shopify-grappe-vm8v1h.avif?width=1080&quality=85&resize=contain)

Une grappe saine : la même liste de balises hreflang sur chaque version.

Résultat attendu

Autant de lignes que de versions publiées de la page, plus `x-default`, et une ligne qui pointe vers l'adresse ouverte.

![Trois carreaux de céramique blanche en triangle, reliés entre eux par un même fil bleu tendu.](https://www.lyvora.agency/media/site/95f83928-782b-4f56-860c-5dfbb7c87b89/hreflang-shopify-illustration-id2ket.webp?width=1080&quality=85&resize=contain)

Chaque version renvoie vers toutes les autres : c'est ce que contrôle l'étape suivante.

## Étape 2 : Contrôler la réciprocité des balises hreflang

Google ignore une balise hreflang si la page cible ne renvoie pas vers la page de départ ([Google Search Central](https://developers.google.com/search/docs/specialty/international/localized-versions)). La console ne voit qu'une page ; ce script Node les visite toutes. Enregistrez-le sous `verifier-hreflang.mjs`, puis lancez `node verifier-hreflang.mjs` suivi de l'adresse d'une fiche, sans paramètre :

JavaScript

```
// node verifier-hreflang.mjs https://www.votre-boutique.fr/products/bougie
const depart = process.argv[2];

const attr = (balise, nom) => balise.match(new RegExp(`${nom}=["']([^"']+)["']`, 'i'))?.[1];

async function lire(url) {
  let rep;
  try {
    rep = await fetch(url, { redirect: 'manual' });
  } catch {
    return { statut: 'injoignable', liens: [] };
  }
  const html = rep.status === 200 ? await rep.text() : '';
  const liens = (html.match(/<link[^>]+>/gi) || [])
    .filter((b) => /rel=["']alternate["']/i.test(b) && /hreflang=/i.test(b))
    .map((b) => ({ code: attr(b, 'hreflang'), url: new URL(attr(b, 'href'), url).href }));
  return { statut: rep.status, liens };
}

const CODE = /^(x-default|[a-z]{2,3}(-[a-z]{4})?(-[a-z]{2})?)$/i;
const page = await lire(depart);
const problemes = [];
if (!page.liens.length) problemes.push('Aucune balise hreflang sur la page de départ.');
if (!page.liens.some((l) => l.url === depart)) problemes.push('La page ne se cite pas elle-même.');
if (!page.liens.some((l) => l.code === 'x-default')) problemes.push('Pas de x-default.');

for (const { code, url } of page.liens) {
  if (!CODE.test(code)) problemes.push(`${code} : code mal formé.`);
  if (/-uk$/i.test(code)) problemes.push(`${code} : le Royaume-Uni s'écrit GB (ISO 3166-1).`);
  if (url === depart) continue;
  const autre = await lire(url);
  if (autre.statut !== 200) { problemes.push(`${code} : ${url} répond ${autre.statut}.`); continue; }
  if (!autre.liens.some((l) => l.url === depart)) problemes.push(`${code} : ${url} ne renvoie pas vers la page de départ.`);
}

console.table(page.liens);
console.log(problemes.length ? problemes.join('\n') : 'Aucun problème : chaque version renvoie vers les autres.');
```

Sur une boutique protégée par mot de passe, chaque page répond par une redirection : le script le signale, et le contrôle n'a de sens qu'une fois la boutique ouverte. Un domaine qui ne répond pas est signalé « injoignable ».

![Tableau des codes hreflang : fr, fr-BE et x-default sont valides ; en-UK, BE seul et fr\_FR ne sont pas reconnus.](https://www.lyvora.agency/media/site/95f83928-782b-4f56-860c-5dfbb7c87b89/hreflang-shopify-codes-36meu6.avif?width=1080&quality=85&resize=contain)

Langue d'abord, pays ensuite, séparés par un trait d'union.

Le service

SEO Shopify

Structure, contenus et performances : le référencement de votre boutique, pensé dès les fondations.

[Découvrir le service](https://www.lyvora.agency/seo-shopify)[Voir une boutique livrée](https://www.lyvora.agency/candlelice)[Recevoir une estimation écrite](https://www.lyvora.agency/contact?parcours=estimation&prestation=seo-geo#contact)

## Étape 3 : Corriger les écarts dans Markets

Une balise hreflang fausse sur Shopify vient presque toujours d'un réglage de marché, pas du thème. Dans l'administration, ouvrez Marchés, puis le marché concerné, et comparez avec le tableau.

| Ce que signale le script | Cause fréquente | Où corriger |
| --- | --- | --- |
| Une langue manque | Langue non publiée sur ce marché | Langues du marché |
| `en` au lieu de `en-GB` | Anglais générique choisi pour le marché | Langue du marché, ou sous-dossier par pays |
| Une version répond 404 | Produit retiré, ou absent du marché de la région de secours | Catalogue du marché |
| Une version redirige | Ancien domaine ou sous-dossier renommé | Domaines du marché |
| Un marché inattendu apparaît | Marché actif oublié | Désactiver le marché |

Shopify précise que la balise `x-default` et les balises de langue seule (`en`, `fr`) pointent vers le marché qui contient la région de secours, réglée dans Paramètres › Général ([aide Shopify](https://help.shopify.com/fr/manual/markets/seo)). Un produit absent d'un marché n'y reçoit pas de balise propre à la région : sa page y répond 404, et il sort du plan du site de ce marché.

Attention

Une application de traduction ou de redirection par pays peut ajouter ses propres balises hreflang. Deux jeux de balises contradictoires valent moins qu'aucun : gardez celui de Markets.

## Étape 4 : Suivre les versions dans la Search Console

Google a retiré son rapport de ciblage international en 2022 : la Search Console ne liste plus les erreurs hreflang. Le contrôle se fait par l'outil d'inspection d'URL, version par version. Inspectez l'adresse britannique, puis l'allemande : chacune doit être sa propre « URL canonique sélectionnée par Google ». Si Google retient la version française pour l'adresse britannique, les deux pages sont jugées en double, souvent parce que la traduction manque.

| Inspection d'URL de la version britannique | Ce que cela veut dire | Que faire |
| --- | --- | --- |
| Canonique sélectionnée : elle-même | Google indexe la version | Rien |
| Canonique sélectionnée : la version française | Pages jugées en double | Traduire ou adapter le contenu |
| URL inconnue de Google | Version jamais explorée | Vérifier le sitemap et les liens |

Check-list

- Chaque version publie la même liste de balises hreflang
- Chaque version se cite elle-même
- Une balise x-default existe et pointe vers le marché de repli
- Aucune version ne répond par une redirection ou une erreur 404
- Aucune application n'ajoute un second jeu de balises

Les balises hreflang complètent la [traduction de la boutique avec Translate & Adapt](https://www.lyvora.agency/blog/academie/traduire-boutique-shopify) et le contrôle des [URL canoniques](https://www.lyvora.agency/blog/academie/balise-canonical-shopify). Vous ouvrez de nouveaux marchés et voulez un regard sur l'ensemble ? Notre page [SEO Shopify](https://www.lyvora.agency/seo-shopify) présente notre façon de travailler, et le [guide du SEO e-commerce](https://www.lyvora.agency/blog/guides/guide-seo-shopify-2026) replace l'international parmi les autres chantiers. Pour en parler, [écrivez-nous](https://www.lyvora.agency/contact).

Votre projet

Un site Shopify ou Webcosa à concevoir ?

Parlez-nous de votre marque, de votre catalogue et de votre calendrier. Le premier échange est un appel de 30 minutes, par téléphone, à l’heure de Paris.

[Recevoir une estimation écrite](https://www.lyvora.agency/contact?parcours=estimation&prestation=seo-geo#contact)[Réserver un appel de 30 min](https://www.lyvora.agency/contact?parcours=appel&prestation=seo-geo#contact)

[SEO Shopify](https://www.lyvora.agency/seo-shopify)[Voir une boutique livrée](https://www.lyvora.agency/candlelice)

## Questions fréquentes

**### Qu'est-ce que la balise hreflang ?**

La balise hreflang est une ligne du code HTML qui associe une page à ses versions dans d'autres langues ou pour d'autres pays. Elle s'écrit `<link rel="alternate" hreflang="en-GB" href="…">`. Google s'en sert pour montrer la bonne version au bon visiteur ; elle n'améliore pas le classement d'une page.

**### Faut-il ajouter les balises hreflang à la main sur Shopify ?**

Non. Shopify Markets publie les balises hreflang de chaque domaine et sous-dossier international dès qu'une langue y est publiée. Les écrire dans le thème en plus crée un second jeu de balises, souvent contradictoire. Le travail consiste à vérifier ce que Markets génère et à corriger ses réglages.

**### À quoi sert x-default ?**

La valeur x-default désigne la page à montrer aux visiteurs dont la langue ou le pays ne correspond à aucune autre version. Sur Shopify, elle pointe vers le marché qui contient la région de secours, réglée dans Paramètres › Général. Une seule balise x-default par grappe de pages suffit.

**### Hreflang et balise canonical se contredisent-ils ?**

Non, si chaque version a sa propre canonical. La page britannique doit être canonique d'elle-même et citer les autres versions en hreflang. Une canonical qui pointe vers la version française annule le hreflang de la page britannique. Shopify pose une canonical par marché, à vérifier avec l'outil d'inspection d'URL.

Écrit par

Ylan ColsonFondateur de Lyvora

Ylan Colson a fondé Lyvora à Paris en 2024. Le studio conçoit et développe des sites vitrines et e‑commerce sur‑mesure, sur Shopify et sur Webcosa.

[Le studio](https://www.lyvora.agency/agence)[Instagram](https://www.instagram.com/ylan.ecom/)

Partager[Partager sur LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fwww.lyvora.agency%2Fblog%2Facademie%2Fhreflang-shopify) [Partager sur X](https://x.com/intent/post?url=https%3A%2F%2Fwww.lyvora.agency%2Fblog%2Facademie%2Fhreflang-shopify&text=Hreflang+sur+Shopify%C2%A0%3A+v%C3%A9rifier+ce+que+Markets+g%C3%A9n%C3%A8re)

Un projet Shopify ou Webcosa ?

Vous échangez directement avec l’équipe qui conçoit et développe votre site.

[Réserver un appel de 30 min](https://www.lyvora.agency/contact?parcours=appel&prestation=seo-geo#contact) [contact@lyvora.agency](mailto:contact@lyvora.agency)

Nos réalisations

## Des boutiques livrées par le studio

[Toutes les réalisations](https://www.lyvora.agency/realisations)

- [![Colliers Mayalice portés : rang de perles et chaîne dorée à breloques, sur un haut en crochet écru](https://www.lyvora.agency/media/site/95f83928-782b-4f56-860c-5dfbb7c87b89/mayalice-couverture-irysok.avif?width=960&quality=85&resize=contain)Bijoux personnalisésRefonte · ShopifyMayaliceRefonte luxe minimaliste et six configurateurs produits pour composer son bijou en direct.](https://www.lyvora.agency/mayalice)
- [![Peignoir Nouvelle Vague crème de Maison Trungadi porté en extérieur, dans la verdure](https://www.lyvora.agency/media/site/95f83928-782b-4f56-860c-5dfbb7c87b89/maison-trungadi-couverture-qympx5.avif?width=960&quality=85&resize=contain)Linge de bainMigration et refonte · ShopifyMaison TrungadiPeignoirs et linge de bain confectionnés en Toscane : une boutique à la hauteur des matières.](https://www.lyvora.agency/maison-trungadi)
- [![Bougie artisanale Candle’lice tenue en main au-dessus d’une planche en bois parsemée de guimauves](https://www.lyvora.agency/media/site/95f83928-782b-4f56-860c-5dfbb7c87b89/candlelice-couverture-207lru.avif?width=960&quality=85&resize=contain)Bougies artisanalesMigration et refonte · ShopifyCandle’liceDes bougies atypiques coulées à la main en France, sorties d’une plateforme qui les bridait.](https://www.lyvora.agency/candlelice)

## Tutoriels voisins

[Tous les tutoriels](https://www.lyvora.agency/blog/academie)

- [Académie · 4 novembre 2026 FAQ schema : ajouter le balisage FAQPage sur Shopify](https://www.lyvora.agency/blog/academie/faq-schema-shopify)
- [Académie · 4 novembre 2026 Shopify CLI : développer un thème Shopify en local](https://www.lyvora.agency/blog/academie/shopify-cli-theme-dev)
