> For the complete documentation index, see [llms.txt](https://docs.hubyte.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hubyte.de/artikel-konfigurator/erste-schritte.md).

# Erste Schritte

## Wo finde ich den Konfigurator?

Die Verwaltung der Felder erfolgt zentral in der Administration unter:

<figure><img src="/files/W2iJg68XK0s0YiURBPxP" alt=""><figcaption></figcaption></figure>

**Kataloge > Artikel Konfigurator**

Darunter finden Sie zwei Menüpunkte:

| Menüpunkt                                            | Inhalt                                                                                                                                                        |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Artikel Konfigurator – Eigene/Zusätzliche Felder** | Hier legen Sie die Felder an und ordnen sie Produkten, Kategorien oder dynamischen Produktgruppen zu.                                                         |
| **Abhängigkeiten von Feldern mit Checkbox**          | Hier definieren Sie, dass Felder erst nach Bestätigung einer Checkbox eingeblendet werden (siehe [Abhängigkeiten](/artikel-konfigurator/abhaengigkeiten.md)). |

## So funktioniert das Plugin im Überblick

Anders als die Shopware-Zusatzfelder (Custom Fields) werden die Felder hier **zentral angelegt** und anschließend zugeordnet. Ein Feld kann dadurch für ein einzelnes Produkt, für ganze Kategorien oder für eine dynamische Produktgruppe gelten – Sie müssen es nicht an jedem Artikel einzeln pflegen.

Der typische Ablauf ist:

1. **Feld anlegen** – Im Konfigurator ein neues Feld erstellen, Feldtyp und Einstellungen wählen (siehe [Felder anlegen & Feldtypen](/artikel-konfigurator/felder-anlegen.md)).
2. **Feld zuordnen** – Festlegen, bei welchen Produkten, Kategorien oder dynamischen Produktgruppen das Feld erscheinen soll (siehe [Feldzuordnung & Prioritäten](/artikel-konfigurator/feldzuordnung.md)).
3. **Optional: Preis / Multiplikator** – Optionen oder Zahlenfelder mit einem Preisaufschlag oder Faktor versehen (siehe [Preisaufschläge & Multiplikator](/artikel-konfigurator/preise-und-multiplikator.md)).
4. **Im Frontend prüfen** – Auf der Produktdetailseite erscheinen die Felder oberhalb des „In den Warenkorb"-Buttons. Die Eingaben werden in den Warenkorb und in die Bestellung übernommen.

## Die Feld-Übersicht

In der Liste **Eigene/Zusätzliche Felder** sehen Sie alle angelegten Felder mit Name, Feldtyp, Platzhalter und Info-Text. Über **Anlegen** erstellen Sie ein neues Feld, per Klick auf einen Eintrag bearbeiten Sie ein bestehendes Feld.

> **Wichtig:** Die Felder werden je Sprache gepflegt. Über den **Sprachumschalter** oben rechts in der Detailansicht können Sie Name, Platzhalter, Info-Text und Auswahlmöglichkeiten pro Sprache hinterlegen.

## Empfohlener Ablauf

1. Überlegen Sie, welche Eingaben Sie vom Kunden benötigen (z. B. Gravurtext, Maß, Farbe, Datei).
2. Legen Sie pro Eingabe ein Feld mit dem passenden Feldtyp an.
3. Ordnen Sie das Feld der gewünschten Ebene zu (Produkt, Kategorie oder dynamische Produktgruppe).
4. Markieren Sie Felder bei Bedarf als **Pflichtfeld** und legen Sie eine **Reihenfolge** fest.
5. Prüfen Sie das Ergebnis auf der Produktdetailseite im Frontend.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hubyte.de/artikel-konfigurator/erste-schritte.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.