Ressources

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

Dev ShopifyCLIToolingCI/CDShopify 2026
Dev · CLI · 2026
Annonce équipe Shopify Dev Platform · 7 avr. 2026

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 production

Scé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 production

Ou via variables d'environnement :

SHOPIFY_FLAG_ALLOW_UPDATES=true
SHOPIFY_FLAG_ALLOW_DELETES=true

Recommandation 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

Développement agentique

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
  • 2
    Pour la majorité des pipelines : --allow-updates suffit. N'ajoutez --allow-deletes qu'en cas de besoin explicite.
  • 3
    Tester le pipeline sur une branche de dev avant de merger sur main.
  • 4
    Vérifier la taille des bundles d'UI extensions (limite 64 KB) avec le metafile esbuild.
  • 5
    Mettre à 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.