En bref. Afficher l’URL canonique de Shopify avec un élément link dont rel vaut canonical et dont href contient {{ canonical_url }}, dans l’en-tête HTML.

Définition : L’objet Liquid canonical_url de Shopify fournit l’URL canonique de la page courante. Le thème affiche cette valeur dans l’attribut href d’un élément <link rel="canonical"> placé dans l’en-tête HTML <head> pour déclarer l’URL préférée de la page.

Points clés

Au 17 octobre 2026, la référence Liquid de Shopify définit canonical_url comme l’URL canonique de la page courante et indique que son accès est global.
Le guide des métadonnées SEO de Shopify présente {{ canonical_url }} dans un élément de lien canonique et place les métadonnées SEO dans <head>.
La documentation sur les mises en page (layouts) de Shopify désigne theme.liquid comme le fichier de mise en page par défaut et situe les fichiers de mise en page dans le répertoire layout.
La documentation sur les URL canoniques de Google décrit les annotations de lien rel="canonical" comme un signal fort pour le choix de l’URL canonique.

Où placer le code Liquid ?

L’exemple de métadonnées SEO de Shopify inclut cet élément de lien dans <head> :

<link rel="canonical" href="{{ canonical_url }}" />

L’expression {{ canonical_url }} insère la valeur de l’objet dans l’attribut de destination du lien. L’attribut rel="canonical" indique la relation entre la page courante et cette destination.

Pour un thème qui utilise la mise en page par défaut, le fichier concerné est layout/theme.liquid. La référence sur les mises en page de Shopify explique que celles-ci regroupent le contenu répété sur plusieurs types de pages, dont les métadonnées SEO. Elle décrit aussi les mises en page personnalisées et leur sélection au niveau des modèles (templates). Pour vérifier les liens canoniques produits par un thème doté de mises en page personnalisées, il faut donc examiner celles qu’utilisent les pages de la boutique.

Quelle valeur l’objet fournit-il ?

La référence de canonical_url définit la valeur par rapport à la page courante. La même expression Liquid peut donc figurer dans le code partagé du thème tout en fournissant l’URL canonique de la page en cours de rendu.

L’accès global signifie que l’objet est disponible dans la mise en page : la documentation sur les mises en page de Shopify précise explicitement que celles-ci peuvent accéder aux objets Liquid globaux. L’exemple de métadonnées utilise directement canonical_url, sans affecter de valeur à une variable distincte ni ajouter de filtre. Cette expression documentée constitue le point de départ pour afficher la valeur fournie par Shopify.

Comment vérifier le résultat ?

Examiner le code HTML de la page rendue pour contrôler le lien canonique, sa valeur href et sa position dans <head>. Les consignes de mise en œuvre de Google n’acceptent cet élément que dans l’en-tête HTML et recommandent des URL absolues. L’URL de destination obtenue doit inclure le schéma et l’hôte, ainsi que le chemin de la page.

Les mêmes consignes recommandent de conserver la déclaration canonique dans le code source HTML et d’empêcher JavaScript de la modifier. Elles recommandent également un lien canonique autoréférent sur la page préférée elle-même. Lors de l’examen du code d’un thème existant, vérifier la présence de déclarations contradictoires : Google déconseille de déclarer des URL canoniques différentes pour une même page au moyen de méthodes différentes, comme un sitemap et un lien canonique.

Termes associés

Questions fréquentes

Dois-je coder en dur l’URL canonique de chaque page ?

Vous pouvez utiliser {{ canonical_url }} dans la mise en page partagée. La référence de l’objet de Shopify définit sa valeur comme l’URL canonique de la page courante.

Puis-je placer le lien canonique dans le corps de la page ?

Placez-le dans <head>. Les consignes sur les liens canoniques de Google précisent que l’élément n’est accepté qu’à cet endroit.

Sources

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO

Comment afficher l’URL canonique de Shopify dans un thème ?