Chaque composant possède ses propres paramètres pour l'affichage, l'affichage des prix, les images, le design et le reporting. Vous les trouvez dans l'éditeur, à gauche, dans l'onglet Paramètres. S'y ajoutent la barre d'en-tête au-dessus de l'éditeur, avec la langue du contenu, l'enregistrement, la réinitialisation et la publication, ainsi que l'onglet Versions. Cet article explique tous les champs.
Les paramètres qui valent pour l'ensemble de votre compte – langues, taux de taxe, domaines, envoi d'e-mails – se trouvent en revanche sous Paramètres dans la navigation principale : Paramètres globaux.
L'éditeur en un coup d'œil
| Zone | Contenu |
|---|---|
| À gauche | Les onglets Caractéristiques, Règles, Paramètres et Versions |
| Au centre | Le sélecteur Modifier / Aperçu |
| À droite | Les paramètres de la caractéristique, du groupe ou de la règle sélectionnés |
| En haut | La barre d'en-tête (voir ci-dessous) |
La création des caractéristiques et des valeurs est expliquée dans Ajouter des caractéristiques & valeurs, les règles dans Créer un jeu de règles.
La barre d'en-tête
| Élément | Effet |
|---|---|
| Langue du contenu : | Apparaît lorsque votre compte a plusieurs langues actives. Vous choisissez la langue dans laquelle vous modifiez les textes. La langue par défaut est marquée (par défaut). Dans toute autre langue, l'éditeur affiche Mode traduction : seuls les champs traduisibles sont visibles et masque tout ce qui n'est pas traduit. |
| Annuler | Annule la dernière modification. Peut être cliqué plusieurs fois tant qu'il y a des modifications. |
| Réinitialiser | Abandonne toutes les modifications depuis la dernière publication et recharge la version publiée. L'admin demande d'abord confirmation : Rétablir la version publiée ? Cette action est irréversible. Pour un composant qui n'a jamais été publié, le bouton n'existe pas. |
| Pas encore en ligne | S'affiche tant que votre état enregistré ou non enregistré diffère de la version publiée. Jusqu'à la publication, les boutiques continuent d'afficher l'ancienne version. |
| Publier | Vérifie le composant, enregistre les modifications en cours et met l'état à disposition des boutiques. Le bouton n'apparaît que s'il y a quelque chose à publier. |
| Enregistrer | Apparaît au-dessus de la zone de droite dès qu'il y a des modifications non enregistrées. L'enregistrement crée un brouillon – vos boutiques ne le voient pas encore. |
La publication en détail
- Cliquez sur Publier. Les modifications non enregistrées sont d'abord enregistrées.
- L'admin vérifie le composant. Les erreurs bloquent la publication : Publication bloquée — ces erreurs doivent être corrigées :. Les avertissements sont affichés, mais la publication reste possible : Avertissements (la publication reste possible) :.
- Si quelqu'un d'autre a enregistré le composant depuis son ouverture, Modification simultanée détectée ! s'affiche. Si vous publiez quand même, vous écrasez ses modifications.
- Confirmez avec Oui, publier.
Onglet Paramètres, section Général

Paramètres de base
| Champ | Effet |
|---|---|
| Titre | Nom du composant dans la vue d'ensemble et dans les plugins de boutique. Modifiable par langue. |
| En-tête | Titre facultatif au-dessus du configurateur. Modifiable par langue. |
| Langue par défaut pour ce composant | La langue dans laquelle vous saisissez les contenus. Utiliser les paramètres globaux reprend la langue par défaut du compte. |
Récapitulatif
| Champ | Effet |
|---|---|
| Afficher la référence combinée | Affiche à la fin du récapitulatif la référence du produit configuré, par exemple « Référence : CL-W-GR ». V3 uniquement. |
La référence combinée se compose des numéros d'article des valeurs choisies, dans l'ordre des caractéristiques et séparés par « - ». Si une valeur choisie n'a pas de numéro d'article, c'est celui de la caractéristique qui compte. Pour une sélection multiple, c'est le premier présent qui compte. Les caractéristiques qu'une règle masque ne comptent pas. Les plugins de boutique reprennent cette même référence dans le panier, et le PDF et l'e-mail du bouton d'action la proposent sous {{combined_sku}}. Dans l'Aperçu, la case Référence combinée l'affiche même si elle est désactivée dans le récapitulatif.
Panier de la boutique
| Champ | Effet |
|---|---|
| Quantité modifiable dans le panier | Activé (par défaut) : le client peut modifier la quantité du produit configuré dans le panier, p. ex. commander trois fois la même configuration. Désactivé : le panier garde la ligne à la quantité 1 et la page produit n'affiche pas de champ de quantité. |
Désactivez ce réglage lorsque le client choisit déjà la quantité dans le configurateur, p. ex. « 100 pièces » avec un prix dégressif. Sinon, la boutique compte la quantité une seconde fois. Le changement s'applique dans la boutique après Publier. Les plugins de boutique le prennent en charge à partir de Shopware 5.3.2, Magento 5.1.5 et PrestaShop 0.6.2, et l'appliquent dans la boutique elle-même : une modification de quantité qui contourne la page reste aussi à 1.
Affichage min / max
| Champ | Effet |
|---|---|
| Afficher min/max | Affiche la plage autorisée pour les champs de saisie qui ont une valeur minimale et maximale. |
| Modèle min/max | Format de cet affichage. $min et $max sont remplacés par les limites, par exemple ($min - $maxcm) → « (40 - 240cm) ». |
Image de produit combinée
| Champ | Effet |
|---|---|
| Image combinée | Non, Image produit combinée (les images des valeurs choisies sont superposées) ou Image combinée 360° (vue rotative, en Legacy et en V3). |
| Animation 360 | Uniquement en 360° : Aucune animation de chargement, Chargement sans pourcentage, Chargement avec pourcentage ou Pourcentage uniquement. Pour les deux dernières options, V3 affiche le même indicateur de chargement avec pourcentage. |
| Séquence initiale en vue 360° | Uniquement en 360° : l'image par laquelle la rotation commence. |
| Afficher l'icône 3D après (sélecteur CSS) | Uniquement en 360° : l'élément de la page après lequel l'icône 3D apparaît. Legacy uniquement. |
Comment déposer les images nécessaires et comment fonctionne la rotation : Visualisation & images.
Supplément
| Champ | Effet |
|---|---|
| Afficher le prix | Affiche les suppléments des valeurs dans le configurateur. |
| Type de prix | Absolu : le supplément de la valeur. Relatif : la différence par rapport à la valeur actuellement choisie. |
| Afficher si zéro | Affiche aussi les suppléments de 0. |
| Modèle de prix | Format de l'affichage. $price est remplacé par le montant avec signe et devise, par exemple [$price] → « [+15,00 €] ». |
En savoir plus sur la logique des prix : Configurer les prix.
Disposition
| Champ | Effet |
|---|---|
| Disposition du groupe | Comment les groupes sont affichés : Aucun groupe, Onglets ou Accordéon (Legacy uniquement). |
| Assistant | Apparaît lorsque Aucun groupe n'est pas sélectionné. Guide pas à pas à travers les groupes. |
| Défilement automatique au changement d'onglet | Uniquement avec l'assistant : remonte jusqu'au configurateur lors du changement d'étape. |
| Décalage supérieur pour le défilement automatique | Uniquement avec l'assistant : distance en pixels par rapport au bord supérieur, par exemple pour un en-tête fixe de la boutique. Valeur par défaut 80. |
| Navigation de l'assistant (V3) | Uniquement avec l'assistant : Onglets, progression et boutons (par défaut), Uniquement Précédent/Suivant ou Aucune si la page de la boutique pilote elle-même les étapes. S'applique uniquement à V3. |
| Position de l'image d'option | Où l'image d'une caractéristique apparaît à côté de la caractéristique : Gauche, Droite ou Ne pas afficher. |
| Vignettes par ligne sur mobile (V3) | Combien de vignettes d'image des caractéristiques de type « Liste avec images » s'affichent côte à côte sur mobile (jusqu'à 767 px de large) : Automatique (par défaut), Une, pleine largeur – l'image garde alors ses proportions – ou Deux côte à côte. S'applique aussi lorsqu'un CSS personnalisé donne aux vignettes une largeur fixe. Les pastilles de couleur restent compactes. Legacy ignore ce réglage. |
| Valeurs exclues par des règles | Masquer (par défaut) : les valeurs qu'une règle exclut disparaissent. Afficher désactivées : elles restent visibles mais ne peuvent pas être choisies – pour les boutons radio, les cases à cocher, les listes déroulantes et les listes avec images. Les caractéristiques qu'une règle masque restent alors visibles elles aussi, grisées et désactivées. Legacy ne connaît ce réglage que pour les valeurs. |
Groupes, onglets et assistant en détail : Groupes de caractéristiques & assistant.
Moteur frontend
| Champ | Effet |
|---|---|
| Moteur | Legacy (par défaut) ou V3. Détermine quel configurateur s'exécute dans la boutique. |
Si le composant contient une caractéristique que seul V3 sait gérer (actuellement le Captcha), la mention Nécessite le Frontend V3 apparaît en haut des paramètres. Ce qui distingue les moteurs et où chacun s'exécute : Moteur frontend : Legacy ou V3.
Onglet Paramètres, section Design
| Champ | Effet |
|---|---|
| Couleur active | Couleur des valeurs choisies, des éléments actifs et du bouton d'action – pour ce composant uniquement. Vide : la couleur de votre CSS, sinon la Couleur principale sous Paramètres → Charte graphique. |
| Couleur de l'animation de chargement | Couleur de l'animation de chargement. En Legacy, utilisée uniquement pour l'image de produit combinée. En V3, elle colore aussi l'indicateur de chargement de la vue 360°. |
| CSS personnalisé | Votre propre CSS, chargé avec le configurateur – pour l'adapter au design de votre boutique. |
| JavaScript personnalisé | Votre propre JavaScript, chargé avec le configurateur. |
Le CSS et le JavaScript personnalisés s'appuient sur la structure du configurateur. Legacy et V3 génèrent un HTML différent – si vous changez de moteur, vérifiez vos adaptations dans l'aperçu. Comment adapter V3 au design de votre boutique avec du CSS et quelles classes restent durablement identiques est expliqué dans Personnaliser le design (CSS).
Onglet Paramètres, section Reporting
Le reporting envoie à Google Analytics 4 des événements qui montrent comment vos clients utilisent le configurateur : quelles valeurs ils choisissent et quelles configurations ils terminent. Il ne fonctionne qu'avec le moteur V3.
Le configurateur ne charge pas de balise Google propre. Il transmet les événements à la balise Google de votre page – à gtag ou, si vous utilisez Google Tag Manager, à son dataLayer. Si la page n'a pas de balise Google, rien n'est envoyé. Le consentement de vos visiteurs reste ainsi géré à un seul endroit : votre bannière cookies et la façon dont vous intégrez votre balise Google.
| Champ | Effet |
|---|---|
| Activer le reporting | Active le reporting et affiche les autres champs. |
| ID de mesure GA4 | Facultatif. Avec un ID de mesure (G-…), les événements vont à cette propriété ; vide, à la propriété utilisée par la balise Google de la page. Les ID Universal Analytics (UA-…) ne fonctionnent plus et sont ignorés. |
| Suivre la configuration complète | Signale en plus chaque valeur choisie lorsque la configuration est terminée. |
| Masquer les caractéristiques | Noms internes des caractéristiques à ne pas signaler, séparés par des virgules. |
Ces événements arrivent dans GA4 :
| Événement | Quand | Paramètres |
|---|---|---|
configento_view |
Le configurateur est chargé. | configento_component_id, configento_component |
configento_select |
Le client choisit une valeur. | en plus configento_characteristic, configento_value |
configento_complete |
La configuration est terminée, par exemple via Ajouter au panier ou un bouton d'action. | en plus value (prix) et currency |
configento_configured_value |
Uniquement avec Suivre la configuration complète : un par valeur choisie à la fin. | comme configento_select |
Les caractéristiques et les valeurs apparaissent avec leur nom dans la langue par défaut du composant ; une boutique multilingue n'obtient donc pas une ligne par langue. Seules les caractéristiques avec des valeurs sont signalées – par exemple liste déroulante, boutons radio, cases à cocher et listes d'images. Le texte libre est exclu, car il peut contenir des données personnelles, que Google n'autorise pas dans Analytics. Rien n'est envoyé depuis l'aperçu de l'éditeur.
Pour exploiter les paramètres dans les rapports GA4, créez-les dans GA4 comme dimensions personnalisées avec le champ d'application « Événement ». Vous pouvez marquer
configento_completecomme événement clé.
Onglet Paramètres, section Champs personnalisés
Vous créez ici vos propres champs supplémentaires, qui apparaissent ensuite sur chaque caractéristique ou chaque valeur – par exemple un numéro de matériau interne ou un code fournisseur.
- Champs pour caractéristiques et Champs pour valeurs : avec Ajouter un champ, vous créez un champ et lui donnez un Nom. Le type est toujours Texte.
- Vous saisissez ensuite les valeurs sur la caractéristique ou la valeur, dans la section Champs personnalisés.
- Les valeurs accompagnent la configuration dans le panier et la commande, afin qu'une boutique ou un ERP puisse les exploiter – pour les valeurs, celles de la valeur choisie lorsque la caractéristique est une sélection simple. Elles ne sont pas visibles pour vos clients. Avec V3, vous les lisez aussi en JavaScript avec
getCharacteristics(), voir Référence de l'API JavaScript.
Les champs personnalisés ne sont pas des champs de saisie pour vos clients. Le nom, l'e-mail ou la société se demandent avec des caractéristiques normales, par exemple avec un petit champ de saisie.
Onglet Versions
Chaque enregistrement crée une version, chaque publication une version marquée Publié. Dans l'onglet Versions, vous pouvez
- comparer une version à votre état actuel avec Comparer au brouillon,
- Sélectionner deux versions et les Comparer,
- Restaurer une version. Elle remplace votre brouillon actuel, mais n'est visible dans la boutique qu'après Publier.
S'il n'y a encore aucune version, enregistrez le composant une fois.
Dépannage
- Une modification n'arrive pas dans la boutique – si Pas encore en ligne s'affiche en haut, cliquez sur Publier. Enregistrer ne suffit pas.
- Le bouton Réinitialiser est absent – le composant n'a jamais été publié. Il n'existe aucune version vers laquelle revenir.
- Je ne vois qu'une partie des champs – vous modifiez une autre langue que la langue par défaut. Sous Langue du contenu :, choisissez la langue marquée (par défaut).
- L'accordéon ne fonctionne pas – le composant s'exécute avec V3. V3 ne connaît pas l'accordéon et affiche les caractéristiques sans groupes.
- L'image 360° ne tourne pas – vérifiez que chaque valeur possède une séquence d'images complète dans la section Images 360°. Les calques avec une seule image ne tournent pas.
- Le reporting ne fournit aucune donnée – le reporting ne fonctionne qu'en V3 et nécessite une balise Google sur la page (voir ci-dessus). Vérifiez aussi que votre visiteur a donné son consentement dans la bannière cookies.
- La référence combinée n'apparaît pas dans le récapitulatif – ni les valeurs choisies ni les caractéristiques n'ont de numéro d'article, ou le composant s'exécute avec Legacy.
- La quantité ne peut pas être modifiée dans le panier – Quantité modifiable dans le panier est désactivé dans le composant. Activez-le et publiez le composant.
- Les valeurs exclues disparaissent au lieu d'apparaître grisées – réglez Valeurs exclues par des règles sur Afficher désactivées et publiez le composant.