Après une mise à jour du thème, cinq vérifications pour que l'abonnement fonctionne encore

Publié le 26 septembre 2026

Une mise à jour de thème remplace des fichiers de la boutique. Quand l'abonnement est affiché par un bloc ou un script ajouté au thème, il peut en sortir intact, déplacé ou absent.

Le moyen de le savoir tient en cinq vérifications, parce que la documentation de Shopify décrit exactement cinq éléments qu'un thème doit porter pour vendre en abonnement.

Ce que le thème doit porter

La page « Add subscriptions to your theme » (shopify.dev) liste les composants à mettre en place :

un sélecteur de formule d'abonnement sur la fiche produit ;
un script qui met à jour les formules disponibles quand le client change de variante, et qui renseigne un champ caché avec la formule choisie ;
l'affichage de la formule dans le panier ;
le montant à payer au moment de la commande, affiché dans le panier ;
l'affichage de la formule sur les pages de commande du client.

La même page précise le rôle du champ caché. Il porte le nom `selling_plan` et contient l'identifiant de la formule choisie. Quand aucune formule n'est choisie, sa valeur doit être vide. C'est ce champ qui dit au panier si le client a choisi un achat unique ou un abonnement.

Les cinq vérifications, une par composant

Faites-les sur la boutique en ligne, dans une fenêtre de navigation privée, sur un produit vendu à la fois à l'unité et en abonnement.

1. Le sélecteur est là, au bon endroit

Ouvrez la fiche. Les deux choix, achat unique et abonnement, apparaissent dans le formulaire du produit, près du bouton d'ajout au panier. S'ils ont disparu ou sont passés sous la description, le bloc n'a pas survécu à la mise à jour ou a été replacé ailleurs.

2. Changer de variante met à jour les formules

Changez de taille ou de couleur. Les formules proposées et le prix affiché doivent suivre. Si le prix reste figé, le script qui met à jour les formules ne tourne plus.

3. Le panier dit ce qui a été choisi

Ajoutez au panier une fois en achat unique, une fois en abonnement. Dans le panier, la ligne abonnée doit indiquer sa formule, la ligne à l'unité ne rien indiquer. Deux lignes identiques signifient que le champ caché n'a pas transmis le choix.

4. Le montant à payer est le bon

Toujours dans le panier, comparez le montant à régler avec le prix affiché sur la fiche pour la formule choisie. Pour un abonnement prépayé, le montant réglé couvre plusieurs livraisons.

5. La commande garde la trace

Passez une commande de test si votre boutique le permet, puis ouvrez-la côté client. La formule d'abonnement doit y figurer. C'est ce que le client relira quand il se demandera pourquoi il a été prélevé.

Ce qu'une mise à jour change rarement, et qu'il faut quand même regarder

L'option sélectionnée à l'ouverture de la page. Les recommandations de Shopify pour les abonnements demandent de sélectionner l'achat unique au premier chargement quand le produit se vend aussi à l'unité. Un bloc réinstallé peut revenir à son réglage d'usine : relisez la fiche avant tout clic, comme un client qui arrive.

Sources

Shopify, « Add subscriptions to your theme », https://shopify.dev/docs/themes/pricing-payments/purchase-options/support-purchase-options (consulté le 24 septembre 2026).
Shopify, « Subscription UX guidelines », https://shopify.dev/docs/themes/pricing-payments/subscriptions/subscription-ux-guidelines (consulté le 24 septembre 2026).

Questions

Pourquoi l'abonnement ne s'affiche plus après une mise à jour du thème ? Le sélecteur d'abonnement est un composant du thème ; une mise à jour peut remplacer le fichier ou le bloc qui le porte. Vérifiez la fiche, le panier et une commande de test.

Comment savoir si le panier a bien reçu l'abonnement ? La ligne du panier doit afficher la formule choisie. Le choix passe par un champ caché nommé `selling_plan`, vide pour un achat unique, selon la documentation de Shopify.

Quelle option doit être sélectionnée par défaut après la mise à jour ? L'achat unique, au premier chargement de la page, quand le produit se vend aussi à l'unité, selon les recommandations de Shopify pour les abonnements.