Recommandez Lyvora à votre réseau et touchez jusqu’à 20 % de commission. Apport d’affaires : jusqu’à 20 %. Découvrir l’apport d’affaires

Écrire sur WhatsApp

Réponses générées par une IA (Mistral) à partir des pages du site. N’indiquez pas d’informations personnelles. Confidentialité

Assistant

Réserver un appel

Réponses générées par une IA (Mistral) à partir des pages du site. N’indiquez pas d’informations personnelles. Confidentialité

Académie · SEO technique 5 min de lecturePublié le

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 18 ou plus, la documentation Google sur les versions localisées
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 Claude Perplexity

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 », 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.

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.
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.
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). 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.
Langue d'abord, pays ensuite, séparés par un trait d'union.

É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). 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

Les balises hreflang complètent la traduction de la boutique avec Translate & Adapt et le contrôle des URL canoniques. Vous ouvrez de nouveaux marchés et voulez un regard sur l'ensemble ? Notre page SEO Shopify présente notre façon de travailler, et le guide du SEO e-commerce replace l'international parmi les autres chantiers. Pour en parler, écrivez-nous.

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 studioInstagram

Partager