Le headless commerce est une architecture e-commerce dans laquelle la vitrine que voient les acheteurs (la « tête ») est séparée du moteur de commerce qui gère les produits, les prix, les paniers, le checkout et les commandes (le back end). Les deux ne communiquent que par des API. Tu peux reconstruire, redessiner ou ajouter un front end sans toucher au back end, et un même back end peut alimenter plusieurs front ends à la fois : un site web, une app mobile, une borne en magasin ou un feed marketplace.
Dans une configuration classique, comme un thème Shopify ou une vitrine Magento standard, la couche de templates et le moteur de commerce forment un seul produit. En headless, une équipe de développement construit la vitrine avec le framework de son choix et récupère chaque produit, prix et panier via l'API de la plateforme. Tu obtiens un contrôle total sur l'expérience, en échange de plus de travail d'ingénierie et d'une exigence plus stricte sur tes données produit. Cet article explique comment ça fonctionne, en quoi c'est différent du commerce classique et du commerce composable, quand c'est rentable et ce que ça change pour les personnes qui gèrent le catalogue.
Les trois couches d'une boutique headless
Une boutique headless comporte trois couches. Chacune peut être détenue, hébergée et modifiée séparément.
- Le front end (la tête) : le code de la vitrine, souvent construit avec un framework JavaScript comme React ou Vue. Il affiche les pages, gère la navigation et appelle les API pour obtenir les données. Il peut y avoir plusieurs têtes : une boutique web, une app iOS et un écran de point de vente.
- La couche API : le contrat entre la tête et le corps. La Storefront API de Shopify fonctionne uniquement en GraphQL, Adobe Commerce propose GraphQL comme base pour les vitrines headless, et la Store API de WooCommerce expose des endpoints de panier et de checkout pour n'importe quel front end.
- Le back end (le corps) : la plateforme e-commerce qui détient le catalogue, le stock, les prix, les promotions, le checkout, les paiements et les commandes. Le contenu produit vient souvent de systèmes supplémentaires, comme un CMS headless pour les pages éditoriales et un PIM pour les données produit.
Un back end, plusieurs têtes
Une requête de page produit dans une boutique Shopify headless illustre le flux. Un acheteur en Allemagne ouvre /de/products/merino-crew-socks-3-pack. La vitrine demande ce produit à la Storefront API avec le pays et la langue réglés sur Allemagne et allemand, et reçoit le titre allemand, la description, les options de variantes (pointures 39 à 42, 43 à 46), les prix en euros et les URL des images. La vitrine affiche ensuite la page avec son propre design. Rien sur cette page ne vient d'un fichier de thème de la plateforme.
Headless ou commerce classique (monolithique)
La différence tient à l'endroit où vit la vitrine et à qui peut la modifier.
Commerce classique et headless, point par point
| Vitrine | Le moteur de thèmes ou de templates de la plateforme | Une application séparée construite par ton équipe ou ton agence |
|---|---|---|
| Modifier le design | Modifier les fichiers du thème dans le cadre des règles de la plateforme | Modifier le code front end sans aucun risque pour le checkout ou la logique de commande |
| Canaux | Une boutique web par installation, plus des apps et plugins pour les autres canaux | Un back end sert autant de têtes que tu veux via la même API |
| Délai de lancement | Quelques jours à quelques semaines avec un thème prêt à l'emploi | En général plusieurs mois, car la vitrine est un projet logiciel |
| Qui peut faire des modifications | Un merchandiser peut réorganiser une page dans l'éditeur de thème | Beaucoup de modifications demandent un développeur, sauf si tu ajoutes un CMS avec éditeur visuel |
| Apps et plugins | Les apps de vitrine (widgets d'avis, blocs d'upsell, filtres) injectent généralement du code dans le thème | Beaucoup doivent être intégrées par API ou reconstruites |
| Hébergement | Hébergé par la plateforme | Le front end doit aussi être hébergé (Shopify propose son propre hébergement Oxygen pour les vitrines Hydrogen) |
Là où le commerce composable et MACH vont plus loin
Ces termes sont liés mais pas identiques. Le headless décrit une seule séparation : le front end du back end. Le back end peut rester une plateforme unique tout-en-un. Beaucoup de boutiques headless font tourner une vitrine React sur mesure au-dessus d'un back end Shopify Plus ou Adobe Commerce standard.
Le commerce composable va plus loin : le back end lui-même est assemblé à partir de services distincts choisis un par un, comme la recherche chez un éditeur, le checkout chez un autre et les promotions chez un troisième. Le headless est un prérequis du composable, mais tu peux être headless sans être composable. L'architecture MACH (microservices, API-first, cloud-native, headless) est l'étiquette de l'extrémité entièrement composable de ce spectre.
Exemples de configurations headless
La plupart des plateformes grand public proposent un mode headless. Quelques schémas courants :
- Shopify avec Hydrogen : le framework de Shopify basé sur React pour les vitrines sur mesure, hébergé sur Oxygen et qui lit la Storefront API. Shopify le présente comme une façon de garder la plateforme « sous le capot » pendant que tu contrôles le front end (Shopify).
- Shopify ou BigCommerce avec une vitrine Next.js : un framework que l'équipe connaît déjà, déployé sur une plateforme d'hébergement généraliste, avec la plateforme e-commerce comme simple back end.
- Adobe Commerce (Magento 2) avec une PWA : une vitrine en progressive web app qui lit les données du catalogue et du panier via GraphQL.
- WooCommerce en headless : WordPress et WooCommerce continuent de gérer le catalogue et les commandes, tandis qu'un front end séparé utilise la Store API pour le panier et le checkout.
- Un back end, plusieurs têtes : une marque fait tourner une boutique web, une app mobile et des écrans tactiles dans ses propres magasins, tous alimentés par les mêmes produits et le même stock.
Les avantages du headless commerce
Les avantages sont réels, mais chacun suppose d'avoir l'équipe pour en profiter.
- Liberté de design : la vitrine peut avoir l'apparence et le comportement que tu veux, sans les limites des sections et réglages d'un thème.
- Rapidité du front end : un framework moderne avec rendu côté serveur, cache en edge et pages légères peut charger plus vite qu'un thème chargé d'une douzaine de scripts d'apps. C'est possible, pas automatique.
- Plusieurs canaux depuis une seule source : apps, bornes, écrans connectés et nouvelles vitrines réutilisent le même catalogue et le même checkout au lieu d'en avoir chacun une copie.
- Cycles de mise en production indépendants : l'équipe front end peut livrer tous les jours sans risque pour le checkout, et une migration du back end n'impose pas de refonte.
- Vitrines internationales : un back end peut alimenter des sites pays distincts, avec leur propre design et leur propre contenu, tout en partageant le stock et les commandes.
Les inconvénients et les coûts du headless
Les équipes qui passent au headless sous-estiment souvent les mêmes coûts.
- Tu deviens propriétaire d'un produit logiciel. La vitrine a besoin de développeurs pour chaque nouvelle fonctionnalité, correction de bug et mise à jour du framework, aussi longtemps qu'elle tourne.
- Un écosystème d'apps perdu : les apps de thème pour les avis, les bundles, les listes de souhaits et les filtres peuvent ne pas fonctionner et doivent être intégrées par API ou reconstruites.
- Moins d'autonomie pour les merchandisers : sans CMS visuel, changer une bannière ou une landing page devient un ticket pour un développeur.
- Un risque SEO pendant la migration : les pages qui dépendent du JavaScript côté client doivent être rendues avant que Google puisse les indexer. Google met les pages JavaScript en file d'attente pour le rendu et recommande toujours le rendu côté serveur ou le pré-rendu, car tous les bots n'exécutent pas le JavaScript (Google Search Central). Balises meta, données structurées, balises canonical et redirections doivent être reconstruites avec soin.
- Plus de systèmes à surveiller : l'hébergement front end, l'API, le CMS et la plateforme e-commerce peuvent chacun tomber en panne séparément.
- Un coût total plus élevé : les coûts de développement, l'hébergement, une licence de CMS headless et le développement continu s'ajoutent à l'abonnement de la plateforme e-commerce.
Le headless commerce est-il fait pour toi ? Une liste pour décider
Utilise-la comme un premier tri. Si la plupart des points de la première liste s'appliquent, le headless mérite un examen sérieux. Si c'est la seconde liste, un thème bien construit est sans doute le meilleur investissement.
Les signes que le headless sera rentable
- Tu vends via plus d'un front end (web plus app, bornes ou plusieurs sites pays) qui doivent partager un seul catalogue et un seul checkout.
- Ton thème bloque réellement des expériences qui génèrent du chiffre d'affaires, comme des configurateurs produit, du shopping éditorial riche ou des bundles sur mesure.
- Tu as, ou peux financer, une équipe front end interne ou un contrat d'agence sur le long terme.
- La vitesse des pages est un problème mesuré que l'optimisation du thème n'a pas résolu.
- Tes données produit sont déjà structurées : attributs typés, variantes propres, traductions et images par canal.
Les signes que ça ne le sera pas
- Ton équipe modifie la boutique surtout via l'éditeur de thème et n'a pas de développeur disponible.
- Tes problèmes de chiffre d'affaires viennent du trafic, de l'assortiment ou du contenu produit, pas de la technologie de la vitrine.
- Tu as une seule boutique dans une seule langue et le thème fait ce dont tu as besoin.
- Ton catalogue a encore des manques : attributs absents, descriptions d'une ligne, unités incohérentes. Un nouveau front end montrera ces manques plus clairement au lieu de les cacher.
Ce que le headless change pour tes données produit
C'est la partie que la plupart des guides oublient. Un thème est tolérant : un marchand peut coller un guide des tailles dans le HTML de la description, mettre la matière dans le titre et ajouter un badge via un réglage du thème. Une vitrine headless affiche des champs. Si une valeur n'est pas dans un champ, le front end ne peut ni la placer, ni filtrer dessus, ni l'envoyer à la tête suivante.
Reprenons les chaussettes en mérinos. Dans une boutique à thème classique, le produit peut ressembler à ceci : titre « Merino socks 3-pack grey/navy/black 43-46 SALE », une description avec un tableau HTML collé pour les tailles, et la matière mentionnée une seule fois au troisième paragraphe. Une vitrine headless, une app mobile et un feed marketplace ont tous besoin du même produit découpé en champs :
- title : Merino Crew Socks 3-Pack (pas de taille, de couleur ni de texte promotionnel dans le titre)
- short_description : une ou deux phrases pour les cartes de listing et les écrans de l'app
- description : un texte simple et structuré, sans HTML de mise en page qui ne fonctionne que dans un seul thème
- material : 80 % laine mérinos, 18 % polyamide, 2 % élasthanne (un attribut typé, pour que la vitrine puisse filtrer dessus)
- pack_size : 3
- variant options : taille (39 à 42, 43 à 46) et couleur (gris, marine, noir) comme vraies options, chaque variante avec son propre SKU, son GTIN et son stock
- care_instructions : lavage en machine à 30 °C, comme attribut que la page produit peut afficher sous forme de liste d'icônes
- images : des images distinctes par variante de couleur, chacune avec un texte alternatif
- seo_title et meta_description : définis par langue, car c'est la tête qui les affiche et il n'y a pas de repli sur le thème
- translations : chaque champ ci-dessus dans chaque langue de vitrine, car un site pays en allemand a aussi besoin de valeurs d'attributs en allemand (Wolle, pas wool)
Le headless a aussi tendance à multiplier les canaux, et chacun a ses propres règles de champs. La boutique web peut afficher une description de 1 200 mots ; la carte de l'app affiche deux lignes ; un feed marketplace impose des limites de longueur de titre. Les données doivent être complètes une fois, puis adaptées par canal : c'est le rôle de la gestion des informations produit. Certaines équipes ajoutent un PIM headless qui sert le contenu produit par API à chaque tête, à côté de la plateforme e-commerce qui garde les prix, le stock et le checkout.
Les pièges de la migration headless, de l'esprit refonte au SEO perdu
- La traiter comme une refonte. Le headless est un changement d'architecture. Prévois le budget pour construire et maintenir un logiciel, pas pour un nouveau look.
- Migrer des données désordonnées telles quelles. Les informations qui vivaient dans le HTML des descriptions, le texte des images ou les titres n'apparaissent pas comme filtres ou caractéristiques dans la nouvelle vitrine. Déplace-les d'abord dans des attributs.
- Oublier la parité SEO. Structure des URL, redirections, balises canonical, données structurées, hreflang et champs meta doivent être reconstruits et testés avant le lancement. Notre guide SEO des pages produit liste les champs à vérifier par page.
- Tout lancer d'un coup. Un déploiement par phases, par exemple en commençant par les pages de listing produit ou un seul site pays, limite le risque.
- Laisser les merchandisers sans outils. Prévois un CMS ou un page builder pour que l'équipe contenu puisse modifier les pages sans développeur.
- Reconstruire la logique du catalogue dans le front end. Les règles de variantes, les traductions et les exceptions par canal ont leur place dans les systèmes qui détiennent les données, pas codées en dur dans les composants de la vitrine.
La couche d'informations produit derrière une vitrine headless
WISEPIM est une couche d'informations produit, pas une vitrine ni un moteur de commerce. Dans une configuration headless, il se place à côté de ta plateforme : il importe le catalogue, complète par AI les attributs, descriptions et traductions manquants, contrôle la complétude avec Quality Guard et pousse le résultat vers la plateforme via la synchronisation des plateformes vers Shopify, WooCommerce, Magento 2 et d'autres boutiques connectées. La vitrine lit ensuite des champs propres et structurés depuis l'API de la plateforme. Quand quelque chose change dans WISEPIM, l'auto-sync (à activer) pousse le produit enregistré vers la boutique connectée, si bien que la tête n'attend jamais un export manuel.
Si tu envisages un projet headless, commence par les données : tu peux importer ton catalogue avec l'offre gratuite et voir quels champs manquent avant tout travail sur le front end.

