> For the complete documentation index, see [llms.txt](https://doku.themeware.design/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doku.themeware.design/zusatzfunktionen/cms-erweiterungen/cms-elemente/datenzuordnung.md).

# Datenzuordnung

Mit der **Datenzuordnung** kannst du Felder eines CMS-Elements dynamisch mit Daten der aktuellen Seiten-Entität (z.B. Kategorie) befüllen. So zeigt z.B. ein Teaser auf einer Kategorieseite automatisch das Kategoriebild und den Kategorienamen an - ohne manuelle Eingabe.

{% hint style="warning" %}
**Wichtig**: Diese Funktion ist nur in der ThemeWare® Pro Edition verfügbar.
{% endhint %}

***

## Anleitung

#### Datenzuordnung zuweisen

1. Öffne die Erlebniswelt einer **Kategorieseite** im CMS-Editor
2. Füge ein unterstütztes CMS-Element ein (z.B. einen Teaser)
3. Klicke in der Element-Konfiguration beim gewünschten Feld auf den Button **"Datenzuordnung"** (1)
4. Wähle die gewünschte Entitäts-Eigenschaft aus (2 – z.B. `category.name` für den Kategorienamen)
5. Speichere die Erlebniswelt

Das Feld wird nun auf jeder Kategorieseite automatisch mit den Daten der jeweiligen Kategorie befüllt.

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

{% hint style="success" %}
**Tipp**: Du kannst in dem Dropdown auch Zusatzfelder (abhängig vom CMS-Layout-Typ) auswählen.
{% endhint %}

#### Datenzuordnung entfernen

Wurden Daten zugewiesen, wird anstelle der Konfiguration ein entsprechender Hinweis (3) in der Element-Konfiguration angezeigt.

Über den Button "Datenzuordnung entfernen" (4) kannst du die Zuweisung jederzeit wieder aufheben.

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

***

## Unterstützte Elemente und Felder

Die Datenzuordnung haben wir in möglichst vielen CMS-Elementen verfügbar gemacht. Ausgenommen sind nur die Elemente, die ohnehin eindeutig verlinkt werden müssen und bei denen eine dynamische Datenzuordnung deshalb keinen echten Mehrwert bringt.

> Dazu kommen noch ein paar Grenzfälle – zum Beispiel Teaser mit Buttons oder Banner, die grundsätzlich verlinkt sein sollten. Hier möchten wir euch bewusst etwas Spielraum lassen: Nicht jedes Element muss die Datenzuordnung nutzen, wenn sie im jeweiligen Fall einfach keinen Sinn ergibt.

### Teaser

| CMS-Element            | Bild | Überschrift/Titel | Text |
| ---------------------- | ---- | ----------------- | ---- |
| Advanced-Teaser        | x    | x                 | x    |
| Classic-Teaser         | x    | x                 |      |
| Hero-Teaser            | x    | x                 | x    |
| Hover-Box              | x    | x                 | x    |
| Image-Teaser           | x    |                   |      |
| Modern-Teaser          | x    | x                 |      |
| Runder Teaser          | x    | x                 |      |
| Teaser                 | x    | x                 |      |
| Text-Teaser            | x    | x                 |      |
| Text-Teaser (verziert) | x    | x                 |      |

### Banner

| CMS-Element     | Bild | Überschrift/Titel | Text |
| --------------- | ---- | ----------------- | ---- |
| Advanced-Banner | x    | x                 | x    |
| Hero-Banner     | x    | x                 | x    |
| Image-Banner    | x    |                   |      |
| Parallax-Banner | x    | x                 |      |

### Sonstiges

| CMS-Element             | Bild | Überschrift/Titel | Text |
| ----------------------- | ---- | ----------------- | ---- |
| Bild & Text überlagernd | x    | x                 | x    |

{% hint style="info" %}

#### Tipp: Zusatzfelder nutzen

Neben den Standard-Eigenschaften (z.B. `product.name` oder `category.media`) kannst du auch **ThemeWare® Zusatzfelder** per Datenzuordnung mappen. So lässt sich z.B. die Kurzbeschreibung statt der Standard-Produktbeschreibung verwenden.
{% endhint %}

***

## Einschränkungen

* Die Datenzuordnung funktioniert nur auf Seiten mit einer zugewiesenen Entität (z.B. Kategorie- oder Produktseiten)
* Auf statischen Erlebniswelten (z.B. Landingpages) steht keine Entität zur Verfügung - die Felder bleiben leer
* Felder mit aktiver Datenzuordnung können nicht gleichzeitig manuell befüllt werden
* Der "Datenzuordnung"-Button ist nur sichtbar, wenn die Erlebniswelt einem Seitentyp mit Entität zugewiesen ist (z.B. Kategorie- oder Produktseiten)