# Zusatzfelder (Custom Fields)

Zusatzfelder sind eine Grundfunktion von Shopware 6 und bieten dir die Möglichkeit, Produkte, Kategorien oder Hersteller individuell zu erweitern. Mit Zusatzfeldern kannst du flexibel zusätzliche Informationen speichern und bei Bedarf in der Storefront ausgeben.

In der folgenden Schritt-für-Schritt-Anleitung erfährst du, wie du ein Zusatzfeld, am Beispiels eines GPSR "Sicherheitshinweis", anlegen kannst.

***

## Zusatzfeld-Set anlegen

In diesem Abschnitt erfährst du, wie du ein Zusatzfeld-Set anlegen kannst.

{% hint style="warning" %}
**Wichtig**: Lege für deine individuellen Zusatzfelder ein separates Zusatzfeld-Set an und nutze nicht bestehende Sets von Erweiterungen oder Themes bzw. ThemeWare®.
{% endhint %}

{% hint style="info" %}
**Hinweis**: Du musst nicht für jedes Zusatzfeld ein eigenes Set anlegen, Sets helfen aber mit steigender Anzahl an Zusatzfeldern die Übersicht zu behalten.
{% endhint %}

#### 1) Neues Zusatzfeld-Set anlegen

Wechsel in die Zusatzfeld-Verwaltung:

> "Einstellungen" => "System" => "Zusatzfelder" => "Set anlegen"

Klicke auf den Button "Set anlegen" und lege ein neues Zusatzfeld-Set an.

* Technischer Name: z.B. `custom_gpsr`
* Label: z.B. `GPSR (Produkte)`
* Verwenden für: Produkte

<figure><img src="https://2128686145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTCpdN4monqL7jrjwbCZL%2Fuploads%2FnyeFb4Njo6cNrN2lG4fa%2Fimage.png?alt=media&#x26;token=df98788d-b85b-4606-9b77-3f1267c11947" alt=""><figcaption><p>Shopware ⇒ Zusatzfeld-Set anlegen</p></figcaption></figure>

***

## Zusatzfeld anlegen

In diesem Abschnitt dieses Tutorials, erfährst du, wie du ein individuelles Zusatzfeld anlegen kannst.

{% hint style="warning" %}
**Wichtig**: Lege deine individuellen Zusatzfelder in einem separaten Zusatzfeld-Set an und nutze nicht bestehende Sets von Erweiterungen oder Themes bzw. ThemeWare®.
{% endhint %}

#### 1) Neues Zusatzfeld anlegen

Klicke nun auf den Button "Neues Zusatzfeld" und lege ein neues Zusatzfeld an.

* Typ: z.B. `Text-Editor`
* Technischer Name: z.B. `custom_gpsr_sicherheitshinweis`
* Label: z.B. `Sicherheitshinweis`

<figure><img src="https://2128686145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTCpdN4monqL7jrjwbCZL%2Fuploads%2F7ohOFUmcks7vA0YLYphJ%2Fimage.png?alt=media&#x26;token=0b1439ff-66b5-4451-89f7-f43b0ebc8b65" alt=""><figcaption><p>Shopware ⇒ Neues Zusatzfeld anlegen</p></figcaption></figure>

#### 2) Zusatzfeld befüllen

Wechsel in die Produkt-Verwaltung und bearbeite das gewünschte Produkt.

Befülle dort das neue Zusatzfeld (z.B. "Sicherheitshinweis"):

> "Kataloge" => "Produkte" => Tab "Spezifikationen" =>  Bereich "Zusatzfelder" => Tab "GPSR (Produkte) => Feld "Sicherheitshinweis"

<figure><img src="https://2128686145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTCpdN4monqL7jrjwbCZL%2Fuploads%2FGG0kXa47rzVhsLUUFsR9%2Fimage.png?alt=media&#x26;token=217a1bf5-fadf-479a-ac93-7d04992e49aa" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Tipp**: Da wir ein Zusatzfeld vom Typ "Text-Editor" erstellt haben, kannst du auch HTML-Formatierungen vornehmen.
{% endhint %}

***

## Zusatzfelder in der Storefront ausgeben <a href="#zusatzfelder-in-der-storefront-ausgeben" id="zusatzfelder-in-der-storefront-ausgeben"></a>

Da weder Shopware noch ThemeWare® wissen können, in welche Datei bzw. in welchem Twig-Block dein individuelles Zusatzfeld integriert werden soll, muss dieses manuell eingebunden werden.

Dies geht entweder mit einem **CMS-Element** in einem Erlebniswelt-Layout oder über eine individuelle **Template-Anpassung**:

### Zusatzfeld mit einem CMS-Element ausgeben

* Vorteile
  * Umsetzung ist sehr einfach
* Nachteile
  * erst ab Shopware 6.6.9 verfügbar
  * keine Abfrage, ob ein Zusatzfeld leer ist, möglich

Wie du ein Zusatzfeld mit einem CMS-Element ausgeben kannst, erfährst du in der folgenden Anleitung:

{% content-ref url="erlebniswelten/zusatzfeld-in-der-erlebniswelt-ausgeben" %}
[zusatzfeld-in-der-erlebniswelt-ausgeben](https://wiki.themeware.design/wissensdatenbank/anleitungen/erlebniswelten/zusatzfeld-in-der-erlebniswelt-ausgeben)
{% endcontent-ref %}

### Zusatzfeld mit einer Template-Anpassung ausgeben

* Vorteile
  * schon vor Shopware 6.6.9 verfügbar
  * eine Abfrage, ob ein Zusatzfeld leer ist, ist möglich
* Nachteile
  * Umsetzung ist recht komplex

Wie du ein Zusatzfeld mit einer individuelle Template-Anpassung ausgeben kannst, erfährst du in der folgenden Anleitung:

{% content-ref url="individuelle-anpassungen/zusatzfelder-in-der-storefront-ausgeben" %}
[zusatzfelder-in-der-storefront-ausgeben](https://wiki.themeware.design/wissensdatenbank/anleitungen/individuelle-anpassungen/zusatzfelder-in-der-storefront-ausgeben)
{% endcontent-ref %}

#### Beispiel

<figure><img src="https://2128686145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTCpdN4monqL7jrjwbCZL%2Fuploads%2FU3iPKQC56fgUPU9roUdk%2Fadmin--gpsr-custom-fields-product-detail.png?alt=media&#x26;token=c6056ad1-265a-44b4-a940-9925abb1f5d7" alt=""><figcaption><p>Zusatzfeld mit einem CMS-Element | Zusatzfeld mit einer Template-Anpassung unter der Beschreibung</p></figcaption></figure>

***

## Weiterführende Informationen

Mehr Informationen zu den Zusatzfeldern von ThemeWare® findest du im ThemeWare® Handbuch:

{% embed url="<https://doku.themeware.design/zusatzfunktionen/zusatzfelder>" %}
ThemeWare® Handbuch ⇒ Zusatzfelder
{% endembed %}