> For the complete documentation index, see [llms.txt](https://docs.hubyte.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hubyte.de/seo-ultimate/faq.md).

# FAQ

## Meine Farbänderungen (Footer/Header) werden nicht angezeigt

Farb- und Layout-Änderungen im Bereich **Conversion & Usability** werden erst nach dem **Neukompilieren des Storefront-Themes** sichtbar. Kompiliere das Theme neu und leere ggf. den Cache.

## Der Newsletter-Bereich erscheint nicht

Für das Newsletter-Banner muss unter **Einstellungen → Stammdaten** ein **Shopseiten-Layout für Newsletterseiten** hinterlegt sein.

## Social-Media-/Header-Icons fehlen

Diese Icons benötigen **Fontawesome**. Trage den **Fontawesome Kit-Code** unter **Einstellungen → Plugins → SEO Ultimate** ein.

## Der Bulk-Generator ist langsam / bricht bei vielen Artikeln ab

Passe die **Generator Block Size** in der Plugin-Konfiguration an. Kleinere Werte sind schonender für den Server, größere Werte schneller (bei ausreichend Serverleistung). Im Zweifel `100`.

## Im Bulk-Generator wird der Produktname nicht eingesetzt

Verwende `{{ product.translated.name }}` statt `{{ product.name }}`. Die `translated`-Variante liefert den übersetzten Wert **inkl. Fallback**; das rohe Feld kann leer sein, wenn keine Übersetzung in der aktuellen Sprache gepflegt ist.

## Die Vorschau/Kategorieauswahl bleibt leer

Klicke bzw. hake eine Kategorie im Baum an, die **direkt Artikel** enthält (oder aktiviere „Für alle Unterkategorien generieren"). Für die Vorschau muss zudem ein Feld mit einem Template gefüllt und aktiviert sein.

## Der Cronjob läuft nicht automatisch

Stelle sicher, dass Shopwares **Scheduler/Message-Consumer** auf dem Server läuft. Den Task kannst du auch manuell auslösen:

```bash
bin/console scheduled-task:run-single hueb_seo.bulk_generate
```

## Die SEO-Analyse zeigt keine Ergebnisse / „Jetzt analysieren" tut nichts

Die Analyse läuft **asynchron** über die Message-Queue. Es muss ein **Message-Consumer/Worker** laufen. Ohne Worker wird der Lauf nicht verarbeitet. Alternativ manuell auslösen:

```bash
bin/console scheduled-task:run-single hueb_seo.analysis
```

## Die SEO-Analyse zeigt „0 gesetzte Metadaten", obwohl Metadaten gepflegt sind

Metadaten sind **pro Sprache** hinterlegt. Prüfe die **Sprachauswahl** oben in der SEO-Analyse und wechsle zur Sprache, in der die Metadaten gepflegt sind.

## Enthält die SEO-Analyse Google PageSpeed?

Nein. Die Performance-Werte (Ladezeit, Seitengröße) stammen aus dem eigenen Sitemap-Crawl; eine Anbindung an Google PageSpeed Insights ist nicht enthalten.

## Der Canonical-Tag wird nicht ausgegeben

Trage im Feld **SEO-Canonical** (Produkt- bzw. Kategorie-SEO-Tab) eine **vollständige URL** inkl. `https://` ein. Ist das Feld leer, gibt Shopware automatisch die Standard-SEO-URL als Canonical aus.