WooCommerce intègre galeries et color swatches au core : ce que cela change pour les extensions

Deux fonctions visuelles entrent dans le core, à des stades différents

WooCommerce a fait entrer deux fonctions visuelles produit dans son core avec la branche 10.9 : les galeries d’images propres à chaque variation et les color swatches. Leur trajectoire se ressemble, mais elles ne sont pas au même stade.

Les variation galleries ont été introduites dans WooCommerce 10.9 comme fonctionnalité opt-in. Leur déploiement a ensuite été prévu en trois étapes : opt-in en 10.9, canary à 5 % sur des boutiques sélectionnées via un DB updater, puis activation à 100 %. WooCommerce prévoit que cette dernière étape arrive avec la version 11.1, avec suppression du feature flag correspondant.

Les color swatches ont eux aussi été introduits dans WooCommerce 10.9, mais comme fonctionnalité expérimentale réservée aux thèmes blocs. Ils restent opt-in : la documentation publiée par WooCommerce ne donne pas, à ce stade, de date d’activation par défaut.

La lecture utile n’est donc pas celle de deux bascules simultanées, mais d’un même mouvement d’intégration progressive appliqué à deux fonctions qui n’ont pas encore le même niveau de maturité.

WooCommerce 11.1 fait des galeries de variations une fonction native

Dans WooCommerce 11.1, les galeries de variations doivent être activées pour toutes les boutiques. Le billet technique publié le 1er septembre précise que l’option wc_feature_woocommerce_additional_variation_images_enabled est supprimée lors de la mise à jour de la base de données et que la fonctionnalité n’apparaît plus dans WooCommerce > Settings > Advanced > Features.

La fonctionnalité auparavant fournie par l’extension Additional Variation Images est alors prise en charge par le core. Lorsqu’elle est activée sur une boutique, l’extension standalone est automatiquement désactivée afin d’éviter les conflits, tandis que les galeries existantes continuent d’être utilisées.

Le passage au core ne s’arrête pas à la technique. WooCommerce prévoit de retirer Additional Variation Images de sa Marketplace une fois le rollout à 100 % atteint. Les abonnements actifs seront alors annulés ; les clients concernés pourront demander un remboursement ou un avoir au support. WooCommerce prévoit également des emails aux marchands concernés aux étapes canary et 100 %, avec les instructions de transition.

Modèle de données et API

Le core stocke les galeries de variations dans _product_image_gallery, la même clé postmeta que celle déjà utilisée pour les galeries des produits parents. L’APIApplication Programming Interface : contrat machine pour consommer un service (HTTP, SDK, webhooks). REST wc/v3 expose ces données via la propriété gallery_image_ids, en lecture et en écriture. L’image principale de la variation reste séparée dans la propriété image.

Migration automatique

Si la migration n’a pas déjà été effectuée, WooCommerce programme un traitement Action Scheduler qui copie les données depuis _wc_additional_variation_images vers _product_image_gallery, par lots pouvant aller jusqu’à 250 variations.

Cette migration est idempotente : elle n’écrase pas une valeur native déjà renseignée. L’ancienne meta _wc_additional_variation_images est conservée pour compatibilité, mais elle n’est plus synchronisée après la prise en charge par le core. Une intégration qui continue à l’utiliser comme source de vérité peut donc diverger de la galerie réellement affichée.

Color swatches : intégrés au core, mais encore expérimentaux

WooCommerce 10.9 introduit un type d’attribut produit Color / Image, identifié en interne par wc-visual. Dans les thèmes blocs, les blocs Filter by Attribute / Product Filters peuvent afficher les swatches dans leurs variantes Chips et List, tandis que le sélecteur de variation sur la fiche produit peut afficher une couleur ou une image plutôt qu’un simple libellé texte.

La fonctionnalité reste activable depuis Settings > Advanced > Features. Elle est explicitement présentée comme expérimentale et entièrement opt-in. WooCommerce recommande de la tester sur un environnement de staging avant utilisation en production.

Le préfixe wc- de wc-visual vise à limiter les conflits avec des extensions qui enregistrent déjà leurs propres types d’attributs. Pour un éditeur d’extension de swatches, c’est donc un identifiant concret à tester dans les contrôles de compatibilité.

Une contrainte de blocs à connaître sur la fiche produit

Pour le sélecteur de variation sur la fiche produit, les color swatches s’affichent à ce stade dans le bloc Add to Cart + Options (Beta). L’auteur de la fonctionnalité précise dans les commentaires du billet qu’il n’existe pas de plan immédiat pour les porter vers le bloc classique Add to Cart with Options.

Cette restriction ne concerne pas les blocs de filtrage catalogue, où les swatches sont également pris en charge via Filter by Attribute / Product Filters.

La synchronisation entre sélection d’une variation et galerie dépend par ailleurs du nouveau bloc Product Gallery. Le bloc Product Image Gallery historique n’est pas compatible avec cette combinaison. Pour une boutique en FSE, le simple fait d’avoir un thème blocs ne suffit donc pas : le template produit doit utiliser les bons blocs pour bénéficier de cette synchronisation.

Ce que les développeurs et agences doivent vérifier

Pour les galeries de variations, quatre vérifications sont particulièrement utiles :

1. Supprimer les conditions basées sur wc_feature_woocommerce_additional_variation_images_enabled, puisque cette option disparaît avec 11.1.
2. Passer par les API prévues par le core, notamment gallery_image_ids dans l’API REST wc/v3, plutôt que par des écritures directes dans les données internes.
3. Ne plus considérer _wc_additional_variation_images comme source de vérité après migration ; la donnée canonique se trouve désormais dans _product_image_gallery.
4. Tester les intégrations storefront lors de la sélection, du changement et de la suppression de variations, surtout lorsque les galeries diffèrent d’une variation à l’autre.

WooCommerce indique explicitement que les overrides du template single-product/add-to-cart/variable.php restent supportés et que les galeries fonctionnent aussi bien sur le storefront classique qu’avec le Product Gallery en blocs. Il n’y a donc pas lieu de présenter les overrides comme incompatibles par principe. Une recette reste néanmoins pertinente sur les boutiques très personnalisées.

Pour les color swatches, les contrôles doivent porter sur wc-visual, sur l’utilisation de Add to Cart + Options (Beta) pour le sélecteur de variation de la fiche produit et, lorsque la galerie doit suivre la variation sélectionnée, sur la présence du nouveau Product Gallery. Les blocs de filtres catalogue constituent un cas distinct et prennent eux aussi en charge les swatches.

Le signal stratégique : davantage de fonctions essentielles dans le core

WooCommerce rattache explicitement l’intégration des galeries de variations à son initiative more in core, dont l’objectif annoncé est d’intégrer davantage de fonctions commerce essentielles directement dans le produit. Le billet de mai 2026 cite également le précédent de Brands, intégré au core avec WooCommerce 9.4.

Pour un éditeur d’extension, le signal est clair : une fonction générique devenue suffisamment centrale dans l’expérience marchande peut finir par être proposée nativement. Cela ne signifie pas que toutes les extensions visuelles sont menacées, mais que la différenciation devient plus importante à mesure que le socle WooCommerce s’élargit.

Pour une agence, l’enjeu est à la fois technique et commercial : chaque mise à jour majeure mérite un contrôle des plugins devenus redondants, des accès directs aux anciennes metas et des abonnements qui peuvent perdre leur raison d’être lorsque leur fonctionnalité rejoint le core.

Pour les marchands utilisant Additional Variation Images, le changement est particulièrement concret : le plugin doit être retiré de la Marketplace au rollout complet et les abonnements actifs annulés. C’est donc aussi un sujet de suivi de facturation et de communication client, pas seulement de compatibilité technique.

Une cadence de release qui impose de suivre les annonces jusqu’au dernier moment

WooCommerce 11.0 est sorti le 4 août 2026, après un report d’une semaine. La version 11.0.1 a suivi le 10 août avec des correctifs de sécurité, de compatibilité et de performance.

La temporalité de 11.1 illustre aussi pourquoi il faut éviter de figer trop tôt une date de sortie. Prévue initialement le 1er septembre, la version stable a été repoussée au 3 septembre 2026, sous réserve de validation de la RC2 préparée après les problèmes détectés en RC1 autour du mini cart.

Au 2 septembre 2026, il est donc plus exact de parler de ce que WooCommerce 11.1 doit activer que de considérer la version comme déjà déployée partout.

Ce qui reste à surveiller

Un problème remonté le 2 septembre 2026 illustre justement cette cadence. Dans les commentaires du billet consacré aux color swatches, un utilisateur de WooCommerce 11.0.1 utilisant Fancy Product Designer a signalé une erreur critique lors de la configuration des termes d’un attribut Color / Image.

Le problème ne vient pas d’un retour null systématique. render_term_visual_column() renvoie tel quel le contenu d’une colonne qu’elle ne traite pas ; son type de retour natif string provoquait alors un TypeError lorsqu’un autre filtre fournissait une valeur non-string. Le correctif retire cette contrainte native et documente le paramètre et la valeur de retour comme mixed. La PR indique également que le bug avait été introduit par la PR #65347.

Le correctif n’est plus en attente : la PR #68264, « Loosen render_term_visual_column return type », a été mergée dans trunk le 2 septembre, avec le jalon 11.1.0. Elle a ensuite été rétroportée vers release/11.1 via la PR #68273, elle aussi mergée le même jour. Le correctif est donc attendu dans WooCommerce 11.1. Ce cycle signalement → correction → backport dans la même journée illustre directement la cadence de stabilisation autour de la release.

D’autres points restent ouverts :

• la date éventuelle d’activation par défaut des color swatches ;
• l’évolution du sélecteur de variation avec swatches au-delà du bloc Add to Cart + Options (Beta) sur la fiche produit ;
• la manière dont les extensions tierces de swatches devront cohabiter avec wc-visual lorsque la fonction gagnera en maturité ;
• les prochaines fonctionnalités que WooCommerce choisira d’intégrer directement au core.

Ces inconnues ne remettent pas en cause le mouvement déjà visible : les primitives produit jugées suffisamment essentielles sont de plus en plus susceptibles de rejoindre le socle natif, avec une période de transition technique, commerciale et éditoriale que développeurs, agences et marchands doivent intégrer à leur maintenance.