Shopify CLI 4.0 : versioning sémantique, auto-updates et ce que ça change vraiment
Par Teo Comyn · Consultant Shopify · CRO, SEO & Liquid · EXPERAISE
Lecture ~8 min · Dev Shopify · CLI · Tooling · CI/CD · Shopify 2026 · Avril 2026 · Mis à jour 2026-04-09
Le 7 avril 2026, Nick Wesselman (Shopify Dev) a publié une annonce qui ressemble à un détail de plomberie. En pratique, c'est l'un des changements d'infrastructure les plus importants pour les développeurs Shopify depuis le passage de CLI 2 à CLI 3 en 2022. Voici ce qui change, pourquoi c'est significatif, et ce que vous devez faire avant mai 2026 si vos pipelines CI/CD utilisent encore le flag --force.
Besoin d'un expert ?
Pour auditer ou industrialiser votre stack CLI : consultant Shopify France et consultant SEO Shopify.
Le problème avec CLI 3 : le versioning « romantique »
Depuis sa sortie en 2022, Shopify CLI 3 a connu plus de 250 releases. Pourtant, le numéro de version ne bougeait presque jamais de façon significative : on passait de 3.47.5 à 3.48.0 à 3.84.1, sans que ces numéros ne communiquent vraiment ce que contenait chaque release. Le terme utilisé dans l'annonce officielle est « romantique », une référence au romversioning, un système volontairement vague.
Conséquence : quand il y avait des breaking changes, Shopify hésitait à sauter de version majeure. Les développeurs ne savaient pas, en lisant un numéro, si une mise à jour était sûre ou risquée. C'était un problème de communication, pas un défaut de technique pure.
La solution : le versioning sémantique standard
Shopify CLI adopte le semver classique, le format MAJOR.MINOR.PATCH familier dans l'écosystème Node. Les releases avec nouvelles fonctionnalités seront des minors. Les correctifs seront des patches. Les breaking changes déclencheront une version major.
Patch
4.0.1, 4.0.2…
Bugfix. Mise à jour sans lire les notes : rien ne casse.
Minor
4.1.0, 4.2.0…
Nouveauté rétrocompatible. Rien n’est retiré.
Major
5.0.0…
Breaking change. Lire la migration avant d’upgrader.
C'est le même contrat qu'avec un package npm sérieux, et c'est une bonne nouvelle pour la prévisibilité des outils.
La nouveauté qui change le quotidien : les auto-updates
Le semver n'est pas une fin en soi : il permet les mises à jour automatiques sur les versions minor et patch. Quand une nouvelle version est disponible, le CLI utilisera votre gestionnaire de paquets pour installer la dernière version, sauf exceptions ci-dessous.
- Pas d'auto-update en CI , GitHub Actions, CircleCI, GitLab : reproductibilité préservée.
- CLI épinglé en dépendance locale , version fixe dans package.json : pas d'auto-update imposé.
- Désactivation possible via variable d'environnement pour les équipes qui veulent un contrôle total.
Jusqu'ici, mettre à jour le CLI était souvent manuel, et les versions divergeaient entre développeurs. Les auto-updates sur patches et minors réduisent cette friction sans sacrifier la CI.
CLI 4.0 : première major sémantique, et fin du --force
La première version major sous le nouveau schéma sera Shopify CLI 4.0, prévue pour mai 2026. Breaking change principal : suppression du flag --force sur shopify app deploy et shopify app release.
Si votre CI utilise --force, ce n'est pas cosmétique : c'est à traiter avant la release.
Pourquoi --force disparaît
Le flag --force sautait toutes les confirmations interactives, y compris celles liées à la suppression d'extensions, opération destructrice sur les boutiques qui ont l'app installée. Il ne distinguait pas les opérations à faible risque (ajouter / mettre à jour) des opérations à haut risque (supprimer).
Un pipeline avec --force qui déploie une config où une extension a été retirée du shopify.app.toml peut supprimer silencieusement l'extension en production, données marchands comprises. La suppression de --force est une décision de sécurité.
Les remplaçants : --allow-updates et --allow-deletes
--allow-updates
Déploie de nouvelles configs et extensions, met à jour l'existant. N'autorise pas la suppression.
--allow-deletes
Autorise la suppression d'extensions, choix délibéré, à réserver aux cas nécessaires.
L'ancien --force équivalait à activer les deux à la fois, sans granularité.
Comment migrer vos pipelines CI/CD
La migration est simple mais doit être faite avant mai 2026. Scénarios courants :
Scénario 1, Déploiement sans suppression (le plus fréquent)
Remplacez --force par --allow-updates :
# Avant (à changer)
shopify app deploy --force --config production
# Après (recommandé)
shopify app deploy --allow-updates --config productionScénario 2, Suppression d'extensions possible
Utilisez les deux flags explicitement si le workflow doit pouvoir retirer des extensions (refonte d'app) :
shopify app deploy --allow-updates --allow-deletes --config productionOu via variables d'environnement :
SHOPIFY_FLAG_ALLOW_UPDATES=true
SHOPIFY_FLAG_ALLOW_DELETES=trueRecommandation Shopify : réserver --allow-deletes aux workflows manuellement déclenchés, pas au pipeline automatique sur chaque push.
Scénario 3, Exemple GitHub Actions
name: Deploy app
on:
push:
branches:
- main
jobs:
deploy:
name: Deploy
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 20
cache: 'pnpm'
- name: Install dependencies
run: pnpm install
- name: Install Shopify CLI
run: pnpm install -g @shopify/cli@latest
- name: Deploy
env:
SHOPIFY_CLI_PARTNERS_TOKEN: ${{ secrets.SHOPIFY_CLI_PARTNERS_TOKEN }}
COMMIT_URL: ${{ github.server_url }}/${{ github.repository }}/commit/${{ github.sha }}
run: shopify app deploy --config production --allow-updates --source-control-url "$COMMIT_URL"Le flag --source-control-url relie un commit GitHub à une version d'app dans le Dev Dashboard, utile pour la traçabilité.
Ce que CLI 4.0 change dans le contexte 2026
Shopify positionne le CLI comme outil clé pour les workflows agentiques, avec le Dev MCP et les agents IA branchés sur la plateforme. Un CLI au comportement prévisible (semver strict) est une condition pour que ces outils s'appuient dessus de façon fiable. Voir aussi GEO / visibilité dans les moteurs IA.
Bundle UI extensions & metafile esbuild
Les builds génèrent un metafile esbuild pour analyser ce qui alourdit le bundle. Les UI extensions Shopify plafonnent à 64 KB : sans visualisation, optimiser relevait du tâtonnement. Croisez avec Core Web Vitals sur Shopify pour la perf globale.
API 2026-04 et shopify.d.ts
Support des extensions en API 2026-04 ; shopify app dev peut générer un fichier shopify.d.ts pour l'objet global shopify avec IntelliSense TypeScript, moins d'erreurs au runtime.
Métaobjects « app-owned »
Les métaobjects détenus par l'app ne nécessitent plus de scopes supplémentaires, moins de friction à l'installation. Pour le balisage côté SEO / rich results, gardez une lecture alignée avec le guide données structurées JSON-LD.
Checklist de migration avant mai 2026
- 1
Rechercher --force dans les scripts. Chaque occurrence sur shopify app deploy ou shopify app release est à remplacer.
grep -r "--force" .github/ .circleci/ Makefile package.json - 2Pour la majorité des pipelines : --allow-updates suffit. N'ajoutez --allow-deletes qu'en cas de besoin explicite.
- 3Tester le pipeline sur une branche de dev avant de merger sur main.
- 4Vérifier la taille des bundles d'UI extensions (limite 64 KB) avec le metafile esbuild.
- 5Mettre à jour api_version = "2026-04" dans shopify.extension.toml si pertinent.
Astuce : gardez une trace des commandes dans la même doc que votre stack outils Shopify.
Ce que ça change pour les développeurs Shopify en France
Pour les équipes qui ship des apps ou des thèmes custom, et pour les consultants qui opèrent des déploiements pour leurs clients, CLI 4.0 clarifie la relation aux mises à jour : patches et minors arrivent sans friction manuelle ; les majors restent un choix explicite, comme sur Next, Vite ou Tailwind.
La suppression de --force est le changement le plus urgent, et souvent le plus rapide à corriger : une passe sur les scripts, puis oubli. Pour un regard externe sur pipeline et accompagnement Shopify, le créneau Calendly reste le bon format pour cadrer.
Récap
Ce qui change
- Semver MAJOR.MINOR.PATCH
- Auto-updates minor/patch (pas en CI)
- CLI 4.0 : fin du --force
- --allow-updates / --allow-deletes
Avant mai 2026
- Remplacer --force par --allow-updates
- Tester sur une branche dédiée
- API 2026-04 + shopify.d.ts
Perspective
Un CLI plus prévisible, pensé pour la sécurité des données de prod et pour les workflows agentiques, pas seulement pour le confort des scripts.
Tu veux qu’on vérifie ta stack ?
Apps, thèmes, CI/CD, un créneau suffit pour prioriser. Réponse rapide sur WhatsApp : ou voir l'offre consultant Shopify France.
Sources & documentation officielle
Liens utiles (hors affiliation) pour creuser le sujet.
Articles connexes
- Tokens hors ligne Shopify : préparer la migration de tes apps avant 2027Classe les apps concernées, distingue les échéances de 2027 et prépare la migration des accès, leur renouvellement et la…
- Shopify Next Gen Events : migrer tes webhooks sans doubler les traitementsDécider si Next Gen Events convient à ton connecteur Shopify : flux pilote, filtres, mapping et recette avant de remplac…
- Apps Shopify : comment diagnostiquer les erreurs API et webhooks sans perdre le fil de tes commandesCommandes ou stocks mal synchronisés ? Une méthode en six étapes pour diagnostiquer les apps Shopify et vérifier la repr…
Accompagnement Shopify
Besoin d'aller plus loin qu'un article ? Pages services et audit.
