Les variantes permettent à un seul produit de couvrir plusieurs options — couleurs, tailles, capacités, marques, modèles. Le client voit un sélecteur clair sur la fiche produit, et vous gardez une seule fiche au lieu de dupliquer le produit par couleur. Cette page est la référence la plus détaillée de la section Vendre parce que les variantes sont la partie qui prend le plus de temps à configurer pour la mode, l'électronique et le digital.

Un produit avec 3 couleurs × 4 tailles a jusqu'à 12 combinaisons. Vous n'êtes pas obligé d'utiliser les combinaisons — la plupart des produits suivent le stock au niveau de l'option ou au niveau du produit (voir §Modes de stock).

Le type se choisit une fois par groupe — toutes les options de ce groupe s'affichent de la même manière :

Deux choses ne valent que pour les groupes Multiple choice (aussi appelés selectable) : ils sont toujours optionnels, et ils n'apparaissent jamais dans la matrice de stock par combinaison.

Le type image-text est plus récent que color et text. Utilisez-le dès que vous avez plus de ~5 options textuelles dans un groupe — la miniature évite que le client confonde des noms similaires (iPhone 14 Pro vs iPhone 14 Pro Max). Quand l'option est liée à une image produit, cliquer dessus peut faire défiler la galerie produit jusqu'à cette image (voir §Clic vers galerie).

Allez dans Dashboard → Products sur /dashboard/products, puis :

Faites défiler jusqu'à la carte Variants, puis :

Les groupes et les options peuvent tous deux être réordonnés par glisser-déposer, et la boutique les affiche dans cet ordre. Le glisser exige un écran de taille desktop avec une souris — il n'y a pas de réorganisation tactile, et les poignées de glissement ne sont pas rendues sur petit écran. Réordonner alors que le stock par combinaison est activé régénère la matrice.

Chaque option comporte :

C'est l'erreur la plus courante en configurant les variantes :

Si votre prix de base est 2 500 DZD et le XL coûte 2 700 DZD, l'ajustement de prix pour XL est +200, pas 2700.

La pastille affiche l'ajustement, jamais le total : +200 s'affiche en pastille verte +200 DZD, -150 en pastille rouge -150 DZD, et une option dont l'ajustement vaut 0 n'affiche aucune pastille. Le total courant du produit, lui, se recalcule dès que le client choisit une option.

La seule surface qui affiche le prix complet de chaque option est l'addon Variantes Produit Digital.

Show as card n'apparaît que sur les groupes Couleur. Activez-le pour afficher cette couleur en grande carte image au lieu d'un cercle de 40 px — utile pour la mode, la bijouterie et les sélecteurs de marque. Il lui faut une image produit liée ; sans elle, l'option retombe sur le cercle simple.

Vous n'en avez besoin nulle part ailleurs : les options image-text et Multiple choice sont toujours des cartes, et les options texte toujours des pastilles.

Tout groupe Couleur, Text et Image-text est obligatoire — le client doit y choisir une option, et le serveur rejette une commande qui arrive sans choix (une protection qui attrape surtout les onglets restés ouverts avant que vous n'ajoutiez le groupe). Il n'existe pas d'interrupteur "required" par groupe.

Pour un groupe véritablement optionnel — gravure, accessoires additionnels — créez-le avec le type Multiple choice. Ceux-là sont toujours optionnels et permettent au client de cocher plusieurs options à la fois.

Quand une option est liée à une image produit, cliquer dessus sur la boutique peut déplacer la galerie vers cette image :

Une fois le produit créé, le rouvrir et y lier une image crée un lien stable vers cette photo, si bien que réordonner ou remplacer les photos plus tard ne casse pas la miniature affichée par l'option. Les variantes configurées sur l'écran de création initial ne peuvent retenir que la position de l'image — réorganisez vos photos ensuite et l'option risque de pointer vers une autre. Le lien devient stable dès le premier enregistrement depuis la page d'édition.

Le défilement de la galerie, lui, va toujours à la position actuelle de l'image dans la galerie.

Il existe trois modes de stock. Ils sont mutuellement exclusifs et se choisissent explicitement avec les interrupteurs de la carte Pricing & stock — il n'y a aucun repli de l'un vers l'autre :

La boutique affiche malgré tout un total unique au niveau produit — elle additionne les compteurs d'options ou de combinaisons pour l'affichage — mais le compteur qui conditionne réellement une vente est celui du mode que vous avez activé.

Dès que le client choisit une variante, le sélecteur de quantité est plafonné par le stock de cette option (ou de cette combinaison), pas par le total produit, et le serveur réapplique le plafond à la soumission de la commande. Seule exception : les offres multi-quantité ne sont pas réduites de cette façon — un lot dont la quantité dépasse le stock de la variante choisie est rejeté à la place.

⚠️ Attention — Prérequis

L'interrupteur Track combination stock n'apparaît qu'une fois que le produit a au moins deux groupes de variantes et que Track variant stock est déjà activé. Si vous ne le trouvez pas, ajoutez le second groupe ou activez d'abord le stock par variante. L'activer masque les champs de stock par option et génère la matrice immédiatement.

Utilisez-le quand :

Sinon, laissez désactivé. Les combinaisons explosent vite : 4 couleurs × 5 tailles = 20 SKUs. 4 × 5 × 3 capacités = 60.

🛑 Important — 1 000 combinaisons, limite stricte

Au-delà de 1 000, la matrice refuse de se générer et affiche un message « trop de combinaisons ». Si une requête arrive malgré tout avec davantage de lignes, le serveur ne conserve que les 1 000 premières et jette le reste sans avertissement. Découpez le produit ou supprimez une dimension — le support ne peut pas relever ce plafond.

Quand le stock par combinaison est activé, la carte Combination matrix apparaît sous les groupes de variantes. Cliquez Generate combinations pour construire la grille, puis remplissez-la. La matrice vous donne :

Les options sont reclassées à chaque clic, et il existe deux apparences « indisponible » différentes. Les marchands signalent régulièrement la seconde comme un bug :

La grille d'images produit (au-dessus de la section variantes) est l'endroit où les marchands passent le plus de temps :

L'ordre est enregistré avec le produit, et c'est ce qu'utilise la boutique pour la galerie et pour le lien option-image.

Les variantes sont dessinées par plusieurs surfaces différentes, chacune avec son propre sélecteur. Vérifiez celle que vos clients utilisent réellement avant de conclure que quelque chose est cassé :

/dashboard/themes propose un onglet Variants avec 12 re-skins CSS du sélecteur. Ils restylent uniquement le sélecteur de la fiche produit partagée — pas la fiche produit du thème Digital, pas les pages de destination, et pas la modale d'ajout au panier.

Certains catalogues ont des options dépendantes — Marque → Modèle. Choisir Apple doit n'afficher que les iPhones, pas les Samsung Galaxies. Installez l'addon Variantes en cascade pour activer les groupes parent-enfant :

Un défaut connu : sur la fiche produit, la surbrillance visuelle « sélectionné » n'est effacée que sur les options couleur et texte, si bien qu'un groupe enfant image-texte peut garder une carte en surbrillance après un changement de parent — la sélection elle-même est bien abandonnée. Les pages de destination effacent correctement les trois types.

Activez-le depuis /dashboard/addons — nécessite le plan Pro ou supérieur.

Quand vous vendez des offres multi-quantité ("Achetez 3, le 4e gratuit"), le client doit choisir des variantes pour chaque pièce. DZBuild le fait déjà nativement avec un accordéon intégré à la page ; l'addon Popup de variantes pour les offres le remplace par une fenêtre modale :

Activez-le depuis /dashboard/addons — disponible sur tous les plans, y compris Gratuit.

Si votre boutique utilise le thème Digital, l'addon Variantes Produit Digital transforme le sélecteur de variantes en un accordéon élégant en deux étapes :

Nécessite le plan Pro ou supérieur et le thème Digital.