Docs  /  Konfigurator aufbauen  /  Gruppen, Darstellung & Wizard

Gruppen, Darstellung & Wizard

Zuletzt aktualisiert: 20. Oktober 2026

Gruppen fassen zusammengehörige Merkmale zusammen – etwa „Maße“, „Material & Farbe“ und „Antrieb“. Wie die Gruppen im Shop erscheinen, bestimmst du mit der Darstellung: alle Merkmale untereinander, als Tabs, als Accordion oder als Wizard, der deine Kunden Schritt für Schritt durch die Konfiguration führt.

Gruppen im Editor

Einstellungen einer Gruppe: Gruppenname je Sprache, Gruppe ausblenden und Gruppe löschen

Jedes Merkmal liegt in genau einer Gruppe. Die Gruppen siehst du links im Reiter Merkmale unter Struktur. Rechts neben Struktur steht, welche Darstellung gerade eingestellt ist.

Aktion So geht's
Gruppe anlegen Ganz unten im Strukturbaum auf Gruppe hinzufügen klicken. Es entsteht eine Gruppe „Neue Gruppe“.
Gruppe umbenennen Am Zahnrad der Gruppe (Gruppeneinstellungen) unter Gruppenname den Namen eintragen – für jede aktive Sprache ein eigenes Feld.
Merkmal in die Gruppe legen Am + der Gruppe (Merkmal hinzufügen) ein neues Merkmal anlegen oder ein vorhandenes Merkmal am Griff ⠿ in die Gruppe ziehen.
Reihenfolge ändern Gruppen und Merkmale am Griff ⠿ an die gewünschte Stelle ziehen. Merkmale lassen sich auch in eine andere Gruppe ziehen.
Internen Namen vergeben In den Gruppeneinstellungen unter Interner Name (ID) einen Namen wie fahrzeug eintragen – optional, nur Buchstaben, Ziffern und Unterstriche, eindeutig je Komponente. Damit sprechen Shop-Entwickler die Gruppe über die JavaScript-Schnittstelle an.
Gruppe ausblenden In den Gruppeneinstellungen unter Sichtbarkeit den Haken Gruppe ausblenden setzen. Die Gruppe erscheint nicht im Konfigurator, ihre Regeln werden aber weiter ausgewertet.
Gruppe löschen In den Gruppeneinstellungen Gruppe löschen.

Achtung beim Löschen: Mit der Gruppe werden alle Merkmale darin unwiderruflich gelöscht. Die Löschung wird sofort gespeichert. Willst du die Merkmale behalten, ziehe sie vorher in eine andere Gruppe.

Eine neue Komponente hat noch keine Gruppe. Lege deshalb zuerst eine Gruppe an, bevor du Merkmale anlegst.

Die Darstellung wählen

Die Darstellung stellst du für die ganze Komponente ein: Reiter Einstellungen → Allgemein → Abschnitt Darstellung.

Darstellung So sieht es im Shop aus Engine
Keine Gruppen Alle Merkmale stehen untereinander, ohne Gruppennamen. Legacy und V3
Tabs Jede Gruppe ist ein Reiter, der Kunde klickt zwischen den Reitern. Legacy und V3
Accordion Jede Gruppe ist ein aufklappbarer Abschnitt. Nur Legacy – V3 zeigt die Merkmale wie bei Keine Gruppen

Ist im Feld Darstellung nichts gewählt (—), zeigen die beiden Engines Unterschiedliches: Legacy zeigt Tabs, V3 zeigt keine Gruppen. Wähle deshalb immer ausdrücklich eine Darstellung.

Mehr zu den Unterschieden der Engines: Frontend-Engine: Legacy oder V3.

Gruppen, die automatisch verschwinden

Eine Gruppe wird im Shop ausgeblendet, wenn keines ihrer Merkmale sichtbar ist – etwa weil eine Regel alle Merkmale der Gruppe sperrt. Eine eigene Regel, die eine ganze Gruppe ein- oder ausblendet, gibt es nicht. Willst du eine Gruppe abhängig von einer Auswahl verbergen, sperre ihre Merkmale.

Der Wizard

Komponente mit Darstellung Wizard: oben im Editor die Schritte, unten Zurück und Weiter

Mit dem Wizard führst du deine Kunden Schritt für Schritt durch die Gruppen: Erst wenn ein Schritt vollständig ist, geht es weiter.

Einschalten: Reiter Einstellungen → Allgemein → Abschnitt Darstellung → Wizard anhaken. Das Feld erscheint nur, wenn als Darstellung nicht Keine Gruppen gewählt ist.

Einstellung Wirkung
Wizard Schaltet die Schritt-für-Schritt-Führung ein.
Auto-Scroll bei Tab-Wechsel Scrollt beim Wechsel zum nächsten Schritt nach oben zum Konfigurator – sinnvoll bei langen Gruppen.
Versatz oben für Auto-Scroll Abstand in Pixeln zum oberen Rand, z. B. für eine feste Kopfzeile deines Shops. Vorgabe 80.
Wizard-Navigation (V3) Was V3 an Navigation zeigt: Tabs, Fortschritt und Buttons (Standard), Nur Zurück/Weiter oder Keine – dann steuert die Shopseite die Schritte über die JavaScript-Schnittstelle. Legacy ignoriert die Einstellung.

So verhält sich der Wizard

Legacy V3
Navigation Unter jeder Gruppe die Knöpfe Zurück und Weiter. Im ersten Schritt fehlt Zurück, im letzten Weiter. Ein Fortschrittsbalken mit „Schritt 2 / 4“ und darunter ← Zurück und Weiter →.
Weiter Prüft die Pflichtfelder des aktuellen Schritts. Fehlt etwas, bleibt der Kunde im Schritt und sieht die Fehlermeldung. Genauso.
Fehler-Regeln Eine Fehler-Regel mit „Ausführen bei“ Wizard hält den Kunden ebenfalls im Schritt und zeigt ihre Meldung. Genauso, wenn der Meldungstyp Fehler ist. Die Meldung steht am Merkmal der Regel, sonst über Zurück und Weiter.
Zurück Immer möglich, ohne Prüfung. Genauso.
Klick auf einen späteren Reiter Prüft alle Schritte bis dorthin. Der Kunde landet beim ersten unvollständigen Schritt. Genauso.
Ausgeblendete Gruppen Werden übersprungen. Werden übersprungen.
Wizard mit Accordion Möglich. Nicht möglich – V3 zeigt bei Accordion keine Gruppen und damit auch keinen Wizard.

Pflichtfelder legst du am Merkmal fest: Abschnitt Verhalten → Pflichtfeld = Ja. Ohne Pflichtfelder lässt der Wizard den Kunden jederzeit weiter.

Eine gute Gruppenstruktur

Ordne die Gruppen so, wie dein Kunde entscheidet – vom Grundsätzlichen zum Detail:

  1. Produkttyp – bestimmt, welche Merkmale danach überhaupt in Frage kommen
  2. Maße – Breite, Höhe, Tiefe
  3. Material & Oberfläche – oft abhängig vom Produkttyp
  4. Ausstattung – Extras und Zubehör
  5. Abschluss – Zusammenfassung und Aktions-Button

Merkmale, von denen spätere Gruppen per Regel abhängen, gehören in frühe Gruppen. Sonst ändert sich beim Zurückblättern plötzlich etwas, was der Kunde schon ausgefüllt hat.

Fehlersuche

  1. Ich kann kein Merkmal anlegen – die Komponente hat noch keine Gruppe. Klicke unten im Strukturbaum auf Gruppe hinzufügen.
  2. Das Feld „Wizard“ fehlt – als Darstellung ist Keine Gruppen gewählt. Wähle Tabs.
  3. Der Wizard lässt Kunden ohne Eingabe weiter – die Merkmale sind keine Pflichtfelder. Setze am Merkmal Pflichtfeld auf Ja.
  4. Accordion erscheint im Shop nicht – die Komponente läuft mit V3. Nimm Tabs oder stelle auf Legacy.
  5. Eine Gruppe fehlt im Shop – sie ist ausgeblendet (Gruppe ausblenden) oder alle ihre Merkmale sind unsichtbar bzw. per Regel gesperrt.
  6. Nach dem Schrittwechsel steht der Konfigurator unter der Kopfzeile des Shops – erhöhe Versatz oben für Auto-Scroll.

Nächste Schritte


← Alle Artikel 14 Tage kostenlos testen