> For the complete documentation index, see [llms.txt](https://docs.premsoft.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.premsoft.de/plugins/cross-selling-warenkorb-und-checkout/dynamische-produktgruppen.md).

# Dynamische Produktgruppen

Dynamische Produktgruppen sind eine **Shopware-Standardfunktion** unter **Kataloge → Dynamische Produktgruppen**. Sie definieren über Filterregeln (z. B. „Hersteller = Acme" oder „Kategorie enthält ‚Kaffee'"), welche Produkte zu einer Gruppe gehören. Sobald du ein neues Produkt anlegst, das die Regel erfüllt, gehört es automatisch zur Gruppe — du musst nichts mehr manuell zuweisen.

Das Plugin nutzt diese Gruppen sowohl für die **Trigger-Produkte** als auch für die **Cross-Selling-Produkte** einer Regel. So sparst du dir laufende Pflegearbeit.

## Wo werden dynamische Produktgruppen verwendet?

* **Trigger-Produkte:** Bestimme über die Gruppe, **wann** eine Regel ausgelöst wird. Beispiel: Liegt irgendein Produkt aus der Gruppe „Kaffeemaschinen" im Warenkorb, schlägt die Regel an.
* **Cross-Selling-Produkte:** Bestimme über die Gruppe, **welche Produkte** als Cross-Selling angeboten werden. Beispiel: Alle Produkte aus der Gruppe „Kaffeebohnen" erscheinen im Slider.

## Eine neue dynamische Produktgruppe anlegen

1. Öffne **Kataloge → Dynamische Produktgruppen**.
2. Klicke auf **Dynamische Produktgruppe hinzufügen**.
3. Vergib einen aussagekräftigen Namen, z. B. `Kaffeebohnen — Aktion`.
4. Definiere unter **Filter** die Bedingungen, z. B. „Kategorie ist `Kaffeebohnen`".
5. Speichere die Gruppe — Shopware zeigt dir sofort eine Vorschau der zugeordneten Produkte.

{% hint style="info" %}
Du kannst Filter beliebig kombinieren. Zum Beispiel „Hersteller = Acme **und** Preis ≤ 50 €" — perfekt für gezielte Aktionen.
{% endhint %}

## Gruppe in einer Regel verwenden

1. Öffne im **Cross-Selling Checkout** eine Regel und gehe zum Reiter **Trigger-Produkte** oder **Cross-Selling Produkte**.
2. Wähle im Feld **Dynamische Produktgruppe** die zuvor angelegte Gruppe.
3. Speichere die Regel — die Gruppe wirkt sofort.

Du kannst Trigger- und Cross-Selling-Liste auch **kombinieren**: zum Beispiel einzelne Trigger-Produkte zusätzlich zur Gruppe pflegen.

## Varianten und dynamische Gruppen

Damit auch Variantenprodukte korrekt erkannt werden, prüft das Plugin **sowohl die Variante als auch das Hauptprodukt** gegen die Gruppe. Eine Regel wie „Wenn ein T-Shirt im Warenkorb liegt" greift damit für alle Größen und Farben des T-Shirts, sofern die Gruppe das T-Shirt selbst oder seine Variante erfasst.

## Beispielszenarien

| Szenario                               | Trigger-Gruppe                   | Cross-Selling-Gruppe |
| -------------------------------------- | -------------------------------- | -------------------- |
| „Wer Hardware kauft, bekommt Zubehör"  | `Hardware`                       | `Zubehör`            |
| „Aktion auf Bohnen zu Kaffeemaschinen" | `Kaffeemaschinen`                | `Kaffeebohnen`       |
| „Reduzierung für Premium-Kund:innen"   | Manuell ausgewählte Top-Produkte | `Treue-Aktion`       |
| „Saisonale Aktion"                     | `Sommerprodukte`                 | `Sommer-Aktion`      |

## Vorteile gegenüber manueller Produktliste

* **Kein Nachpflegen** beim Sortimentswechsel — neue Produkte fließen automatisch ein.
* **Skalierbar** — auch tausende Produkte sind problemlos abgedeckt.
* **Wiederverwendbar** — dieselbe Gruppe kann in mehreren Regeln und sogar im Shopware-Standard-Cross-Selling oder in Aktionen wiederverwendet werden.

## Wann lieber eine manuelle Liste?

* Wenn die Cross-Selling-Auswahl bewusst **kuratiert** sein soll.
* Wenn du **feste Reihenfolge** der Produkte im Slider erzwingen möchtest — bei manueller Liste lässt sich die Position pro Produkt setzen.
* Bei sehr kleinen Aktionen mit wenigen Produkten — dort ist die Pflege per Hand schneller als das Anlegen einer Gruppe.

{% hint style="info" %}
Manuelle Listen und dynamische Gruppen lassen sich **kombinieren**. So pflegst du z. B. 3 Top-Empfehlungen manuell mit fester Position und füllst die restlichen Plätze über eine Gruppe auf.
{% endhint %}


---

# 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.premsoft.de/plugins/cross-selling-warenkorb-und-checkout/dynamische-produktgruppen.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.