---
title: Produktkategorien importieren
description: So importieren Sie Produkt-Kategoriezuweisungen und Hauptkategorien in Shopware 6 mit categories_all_paths, categoryIds und main_category_#-Spalten.
---

Sie können Produktkategorien mit einem dieser Felder importieren:

- `categories_all_paths` - enthält den vollständigen Kategoriepfad ab der Root-Kategorie. Wenn eine Kategorie in Ihrem Shop nicht existiert, erstellt unsere App sie automatisch.
- `categoryIds` - Kategorie-UUIDs, getrennt durch eine Pipe `|`

Hier ist ein Beispiel für die Struktur Ihres Shops:

![](/images/Screenshot_2025-02-16_at_13.35.38.png)

Um ein Produkt der Kategorie `Women` zuzuweisen, verwenden Sie entweder:

| productNumber | categories_all_paths |
| --- | --- |
| FBPRD001 | Home/Shoes/Women |

oder

| productNumber | categoryIds |
| --- | --- |
| FBPRD001 | 01949d590ee775e09a05e27a30b18875 |

Um ein Produkt mehreren Kategorien zuzuweisen, trennen Sie diese mit einer Pipe `|`:

| productNumber | categories_all_paths |
| --- | --- |
| FBPRD001 | Home/Shoes/Women\|Home/Accessories |

## Hauptkategorien importieren

In Shopware können Sie pro Verkaufskanal eine Hauptkategorie für ein Produkt festlegen. Shopware verwendet die Hauptkategorie für die SEO-URL-Erzeugung und das Breadcrumb-Verhalten im Storefront.

Verwenden Sie einen dynamischen Spaltennamen mit dem Verkaufskanal nach `#`:

- `main_category_#Storefront`
- `main_category_#98432def39fc4624b33213a56b8c944d`

Der Teil nach `#` kann der Name des Verkaufskanals oder die 32-stellige Verkaufskanal-ID sein. Als Wert können Sie eine Kategorie-ID, einen Kategoriepfad oder einen eindeutigen Kategorienamen verwenden.

:::caution
Die Hauptkategorie muss demselben Produkt bereits über `categories_all_paths`, `categoryIds` oder eine bestehende Produkt-Kategoriezuweisung zugeordnet sein. Wenn die Kategorie dem Produkt nicht zugeordnet ist, überspringt die App diesen Hauptkategorie-Wert und schreibt eine Warnung ins Protokoll.
:::

Beispiel mit Kategoriepfad:

| productNumber | categories_all_paths | main_category_#Storefront |
| --- | --- | --- |
| FBPRD001 | Home/Shoes/Women | Home/Shoes/Women |

Beispiel mit Kategorie- und Verkaufskanal-IDs:

| productNumber | categoryIds | main_category_#98432def39fc4624b33213a56b8c944d |
| --- | --- | --- |
| FBPRD002 | 01949d590ee775e09a05e27a30b18875 | 01949d590ee775e09a05e27a30b18875 |

Wenn der Wert in `main_category_#...` leer ist, lässt die App die vorhandene Hauptkategorie unverändert.

## Produktkategorien ersetzen

Standardmäßig verwendet unsere App ein Anhängeverhalten. Das bedeutet, Kategorien aus der Importdatei werden mit bestehenden Produktkategorien zusammengeführt.

Wenn Sie bestehende Kategorien stattdessen ersetzen möchten, aktivieren Sie die Option **Replace product categories** in den Einstellungen des Importprofils. Dadurch werden zuerst alle aktuellen Produkt-Kategoriezuweisungen entfernt, bevor neue Kategorien importiert werden.

![](/images/Screenshot_2025-02-16_at_13.41.06.png)

> ☝ **Tipp:** Sie können alle Produktkategorien entfernen, indem Sie **Replace product categories** aktivieren und einen leeren Wert für `categories_all_paths` verwenden.