---
title: "Kategorien-Verwaltung im PIM für Shopware"
description: "Kategorien-Verwaltung im PIM für Shopware: Baum je Verkaufskanal, KI-Texte und Übersetzung, SEO-URLs mit 301, Kategoriebilder, Produktzuordnung und Backup."
url: https://pim-shopware.de/dokumentation-kategorien.html
language: de
---
# Kategorien-Verwaltung im PIM für Shopware: Anleitung
Mit der Kategorien-Verwaltung im PIM für Shopware pflegst du den kompletten Kategoriebaum, ohne den Shopware-Standard zu verlassen: anlegen, verschieben, übersetzen, SEO-URLs setzen, Bilder zuweisen, Produkte zuordnen, KI-Texte generieren und den ganzen Baum als CSV oder JSON sichern, pro Verkaufskanal und Sprache.

## Kategorien-Verwaltung in Shopware öffnen: Aufbau
Der Button „Kategorien" (links neben dem Feed-Generator in der Produktliste) öffnet das Modal. Die Verkaufskanal-/Sprach-Auswahl nutzt den Channel-Bar im Stammdaten-Stil (mit Icons und Feld-Rahmen). Pro Kanal wird der Baum ab der Navigations-Wurzel aufgebaut, die Einstiegskategorie steht oben. Geladen wird direkt über das category -Repository, kein separater API-Endpoint, keine eigene Seite. Abgesichert über den Funktionsschalter „Kategorien verwalten" für normale Benutzer (siehe Rechte & Superadmin).

## Anlegen, bearbeiten, verschieben
- Neue Kategorie über den Button in der Leiste, schnell eine Wurzelkategorie im gewählten Kanal, oder als Unterkategorie. Neue Kategorien werden in der Systemsprache angelegt.
- Umbenennen, aktivieren/deaktivieren, löschen direkt im Baum bzw. Detailbereich. Die Lösch-Bestätigung ist ein Dialog im PIM-CI-Stil (kein Browser-Confirm).
- Drag & Drop: Kategorien unter einen anderen Übergeordneten ziehen.
- Duplizieren im Detail-Kopf, dupliziert die Kategorie inklusive aller Unterkategorien (Subtree) als Geschwister mit Namenszusatz „(Kopie)".

## Felder je Sprache, Typ & Layout
Name, Beschreibung und SEO-Felder werden pro Sprache gepflegt; ein Sprachwechsel lädt Baum und Detail neu, sodass übersetzte Felder erscheinen. Die Sprachauswahl zeigt dabei nur die dem aktiven Verkaufskanal zugewiesenen Sprachen: keine irrelevanten Sprachen, die im Kanal gar nicht ausgespielt werden. Die Beschreibung ist ein WYSIWYG-Editor (sw-text-editor) mit sichtbarer HTML-Formatierung. Dazu:
- Typ & übergeordnete Kategorie setzen, externer Link bei Link-Kategorien
- Layout (CMS-Erlebniswelt) zuweisen, inkl. Button „Neue Erlebniswelt anlegen" (öffnet den CMS-Editor in neuem Tab)
- Schalter „In Hauptnavigation anzeigen", Zusatzfelder-Abschnitt
- Standard-Sortierung (Shopware product_sorting), gespeichert über die Kategorie-Slot-Konfiguration; „Standard (vererbt)" entfernt den Override wieder

## Kategoriebild & Alt-Text
In den Stammdaten (direkt über „In Navigation anzeigen") sitzt das Kategoriebild (Cover) mit Vorschau: aus der Mediathek wählen oder direkt hochladen, entfernen. Gespeichert als category.mediaId, Uploads landen im Kategorie-Medienordner. Ein Alt-Text-Feld (sprachabhängig, am Mediendatensatz gespeichert) verbessert Barrierefreiheit und SEO.

## SEO-URL (Slug) pro Kanal & Sprache
Im Bereich „Beschreibung & SEO" lässt sich je Verkaufskanal und Sprache ein SEO-URL-Slug setzen. Beim Öffnen wird die aktuelle Canonical-URL geladen, beim Speichern über einen Backend-Endpoint geschrieben:
- Die alte URL bleibt als 301-Weiterleitung erhalten (alter Eintrag wird non-canonical), die neue wird Canonical und als manuell markiert, Shopware überschreibt sie beim Reindex nicht.
- Der Slug wird zusätzlich zuverlässig im Zusatzfeld staw_pim_seo_url der Kategorie gespeichert (über den normalen Speichern-Vorgang).
- Leeres Feld = Override entfernen, Shopware generiert wieder automatisch.

## Produktzuordnung: Stream oder Preset
In der Sektion „Produkte" wird gesteuert, welche Produkte in der Kategorie liegen, in zwei klar getrennten Optionen:
- Dynamische Produktgruppe (Stream): eine Shopware-Produktgruppe (product_stream) auswählen; gespeichert werden productAssignmentType=product_stream und die productStreamId.
- Preset (StawPim-Filter): ein StawPim-Filter (staw_pim_filter) mit Live-Trefferanzahl. Beim Speichern im Preset-Modus werden die aufgelösten Produkte der Kategorie fest zugewiesen, sodass sie im Frontend erscheinen. Schutz: 0 Treffer leert die Kategorie nicht.
Die Preset-Anzeige zeigt Hauptartikel und Varianten getrennt (wie im Listing). „Kein Preset" entfernt die Zuordnung wieder.

## Vollständigkeits-Score
Jede Kategorie im Baum zeigt einen Prozent-Score (grün/gelb/rot) basierend auf gefüllter Beschreibung, Meta-Titel, Meta-Description und Kategoriebild. Im Detailbereich wird der Score live neben dem Titel angezeigt und aktualisiert sich beim Bearbeiten. Ein Filter nach Vollständigkeit neben der Suche zeigt gezielt unvollständige Kategorien.

## KI-Texte & Übersetzung
Ein Button „KI-Texte" generiert Beschreibung, Meta-Title, Meta-Description und Keywords, über alle vier KI-Anbieter, mit Tonalitätswahl, Ausgabe in der aktiven Sprache und freiem Feld „Weitere Anweisungen an die KI". Schalter „Unterkategorien einbeziehen" (ganzer Unterbaum) und „Bestehende Texte überschreiben".
- „Übersetzen" steht zusätzlich einzeln neben „KI-Texte", Übersetzung der Felder von Quell- in Zielsprache per DeepL oder KI-Anbieter.
- Bulk: Mit „Alle auswählen" + Bulk-Button werden KI-Texte oder Übersetzungen für alle ausgewählten Kategorien auf einmal erzeugt. KI-Fehler zeigen die echte Ursache (curl-Fehler + Upstream-Status) statt nur „Proxy HTTP 502".

## Massenaktionen im Baum
Kategorien lassen sich im Baum per Checkbox mehrfach auswählen. Eine Bulk-Leiste zeigt die Anzahl und bietet „Aktiv/Inaktiv setzen" sowie „In Nav anzeigen/ausblenden". Vor jeder Aktion wird ein benannter Snapshot des vorherigen Zustands erstellt; ein Button „Verlauf" listet Snapshots (wiederherstellbar) samt Audit-Log.

## Import / Export
Über den Button „Import/Export" lässt sich der komplette Kategoriebaum des gewählten Verkaufskanals verwalten:
- CSV-Export inklusive Zusatzfeldern als eigene cf. -Spalten. Mehrsprachig: je übersetzbarem Feld eine Spalte pro Shop-Sprache im Format feld.locale (z.B. name.de-DE, description.en-GB).
- CSV-Import löst die übergeordnete Kategorie über die Spalte parentPath (Pfad mit „>") auf, legt fehlende Kategorien an und aktualisiert bestehende (gleicher Pfad + Name). Mit Vorschau und Validierung (Name/Typ/Parent).
- Baum als JSON sichern: vollständiges Backup inkl. aller Sprachen, Zusatzfelder und IDs, ideal vor größeren Umbauten. Wiederherstellen = erneut importieren.

## Aus Standardsprache übernehmen
Legt ein Verkaufskanal eine eigene Sprache an, sind dort zunächst keine eigenen Kategorietexte hinterlegt. Im Shop greifen die geerbten Inhalte, eine gezielte Pflege oder KI-Überarbeitung je Kanal ist ohne Ausgangstext aber nicht möglich. Die Sammelaktion „Aus Standardsprache übernehmen" überträgt Name, Beschreibung, Meta-Titel, Meta-Description und Keywords aus der Standardsprache in die aktuell gewählte Sprache.
- Eigener Dialog: Vor dem Start nennt er die Anzahl der Kategorien, die Zielsprache und die zu übertragenden Felder und weist darauf hin, dass vorhandene eigene Texte übersprungen werden.
- Fortschritt sichtbar: Während der Übernahme läuft ein Fortschrittsbalken; danach schließt sich der Dialog und die Ansicht wird aktualisiert.
- Nichts wird überschrieben: Bereits vorhandene eigene Texte bleiben unangetastet. Die Meldung nennt am Ende, wie viele Kategorien übernommen und wie viele übersprungen wurden.
- Die Schaltfläche erscheint nur, wenn die gewählte Sprache von der Standardsprache abweicht.

## Sprachen im Baum: was der Prozentwert zeigt
- Nur eigene Texte zählen: Der Vollständigkeits-Score je Kategorie rechnet ausschließlich mit den eigenen Texten der gewählten Sprache, passend zum Bearbeitungsformular daneben, in dem ebenfalls je Sprache gepflegt wird. Geerbte Inhalte fließen nicht ein.
- Baum folgt der Kanalsprache: Beim Öffnen wird der Baum in der Sprache des zuerst gewählten Verkaufskanals aufgebaut, sodass Namen und Prozentwerte links zur Sprachanzeige oben passen.
- Sofort sichtbare Änderungen: Nach Sammelaktionen und nach einem Import wird neben dem Baum auch die Bearbeitungsansicht rechts aktualisiert.

## Weiter geht's
Weiter zu CSV-Import & Export, um Produktdaten per Datei ein- und auszulesen.
- Shopware Kategorien importieren und exportieren: ganzer Baum per CSV

## Häufige Fragen

**Kann ich Kategorietexte per KI schreiben lassen?**
Ja. Beschreibung, Meta-Title, Meta-Description und Keywords entstehen per KI, auch als Sammelaktion über viele Kategorien.

**Was passiert mit der alten URL, wenn ich den Slug ändere?**
Sie bleibt als 301-Weiterleitung bestehen, die neue URL wird kanonisch.

**Wie ordne ich Produkte einer Kategorie zu?**
Über eine Shopware-Produktgruppe oder über ein Preset aus dem PIM mit Live-Trefferzahl.

**Lässt sich der Kategoriebaum sichern?**
Ja, als CSV zum Bearbeiten und Wiedereinlesen sowie als JSON-Backup mit allen Sprachen, Zusatzfeldern und IDs.