Next.js hreflang

Next.js hreflang : implémenter des alternatives linguistiques dans le routeur d’applications

Un guide pratique sur les routes locales, les liens hreflang réciproques, les métadonnées traduites et les pages dynamiques dans une application Next.js App Router.

La réponse courte

L'annotation hreflang fonctionne lorsque chaque version linguistique possède sa propre URL indexable, identifie l'ensemble des langues et renvoie vers les autres versions. Dans Next.js, il est recommandé de générer ces relations à l'aide de métadonnées prenant en compte les routes, plutôt que de se fier uniquement à la détection automatique de la langue par le navigateur.

/ 01

Commencez par les URL

Offrir à chaque version linguistique un itinéraire stable

Utilisez une structure de routes telle que /fr/pricing ou /de/products/widget. La page doit être accessible directement, afficher la version dans la langue correspondante sur le serveur et rester valide lorsqu'un robot d'exploration la demande sans cookies de navigateur ni préférence Accept-Language.

  • Conservez une URL canonique par version linguistique.
  • Utilisez des slugs stables ou une stratégie de slugs localisés documentée pour les pages dynamiques.
  • Renvoyer une réponse 200 réelle pour chaque route de langue publiée.
Forme de route du routeur d'application
app/
  [locale]/
    products/
      [slug]/
        page.js
        opengraph-image.js
    layout.js
    sitemap.js

// /fr/products/widget
// /de/products/widget
/ 02

Générer des métadonnées

Créer des relations linguistiques réciproques

Les métadonnées de Next.js prennent en charge un objet `alternates.languages`. Générez le même ensemble complet de langues à partir de chaque page de localisation afin que les versions anglaise, française et allemande pointent toutes entre elles.

  • Inclure la page actuelle dans sa propre carte linguistique.
  • Utilisez des URL HTTPS complètes en production.
  • Veillez à ce que les codes de langue soient cohérents avec les valeurs de paramètres régionaux utilisées par votre application.
générerMetadata avec Altified
import { headers } from "next/headers";
import { altified } from "@/lib/altified";

export async function generateMetadata() {
  const locale = (await headers()).get("x-altified-locale") || "en";

  return altified.translatedMetadata({
    locale,
    path: "/pricing",
    origin: "https://example.com",
    locales: ["en", "fr", "de"],
    title: "Pricing",
    description: "Plans for your product.",
  });
}
/ 03

Afficher le contenu

Faites correspondre la langue de la page à l'URL

Hreflang n'est pas un mécanisme de traduction. La page à l'adresse /fr/products/widget doit afficher le contenu, les métadonnées, la navigation, les données structurées et les valeurs dynamiques pertinentes en français. Déterminez la langue active avant que la réponse n'atteigne le navigateur.

  • Traduisez ensemble les titres, les descriptions, les champs Open Graph et les en-têtes visibles.
  • Transmettre les paramètres régionaux actifs aux API backend.
  • Utilisez les traductions de repli dans la langue source pendant qu'une traduction est en cours.
Transférez le lieu actif
const response = await altifiedFetch(BACKEND_URL + path);

// The active Altified locale is forwarded to the backend.
const product = await response.json();
/ 04

Valider le cluster

Vérifiez les deux sens avant le lancement

Les moteurs de recherche peuvent ignorer les groupes de langues incomplets ou contradictoires. Testez chaque page publiée dans une langue, examinez son en-tête rendu et vérifiez que les liens sont réciproques et que chaque page possède une URL canonique.

  • L'anglais renvoie au français, à l'allemand et à l'anglais.
  • Le français désigne l'anglais, l'allemand et le français.
  • Chaque balise canonique utilise la même langue que le contenu de la page.
  • Les sites non publiés ou incomplets ne sont pas présentés comme des alternatives viables.

/ Liste de contrôle de production

Vérifiez l'expérience linguistique avant le lancement.

  • Chaque région possède une URL directe et indexable.
  • Chaque page en langue renvoie le contenu traduit et les métadonnées.
  • Les liens hreflang sont réciproques.
  • Les balises canoniques sont autoréférentielles dans le langage de la page.
  • Les itinéraires dynamiques des produits et des articles sont inclus.
  • Le plan du site contient l'ensemble des URL de langue.

/ Foire aux questions

Questions que se posent les équipes avant de mettre en œuvre un référencement multilingue.

Next.js génère-t-il automatiquement les balises hreflang ?

Next.js fournit des API de métadonnées pour les variantes linguistiques, mais votre application doit fournir les URL de localisation et le mappage de langue corrects.

Les URL hreflang doivent-elles être absolues ?

Utilisez des URL HTTPS complètes dans les métadonnées de production et les sitemaps afin que les relations linguistiques soient sans ambiguïté.

Ai-je toujours besoin des balises canoniques lorsque j'utilise hreflang ?

Oui. L'attribut hreflang décrit les versions linguistiques ou régionales équivalentes ; chaque page localisée doit néanmoins identifier sa propre URL canonique.