> 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/canonical.md).

# Canonical-URLs

Mit einer **Canonical-URL** teilst du Google mit, welche URL die „richtige" (kanonische) Variante einer Seite ist. Das hilft gegen Duplicate Content, z. B. bei Produkten in mehreren Kategorien oder bei Filter-/Paginierungs-URLs.

SEO Ultimate erlaubt das Setzen einer **individuellen Canonical-URL pro Produkt und pro Kategorie**. Ist kein eigener Wert hinterlegt, bleibt der Shopware-Standard (die SEO-URL der Seite) aktiv.

## Produkt-Canonical

1. Produkt öffnen → Tab **SEO**.
2. In der Karte **SEO-Canonical** eine vollständige URL im Feld *Benutzerdefinierter Canonical Tag* eintragen.
3. Speichern.

Unter dem Feld siehst du eine **Live-Vorschau** des ausgegebenen Tags:

```html
<link rel="canonical" href="https://dein-shop.de/dein-produkt">
```

Ist das Feld leer, zeigt die Vorschau den **Shopware-Standard** (die Produkt-SEO-URL).

> **Varianten:** Der Wert kann von der Vererbung des Hauptprodukts übernommen oder pro Variante überschrieben werden.

## Kategorie-Canonical

1. Kategorie öffnen → Tab **SEO**.
2. In der Karte **SEO-Canonical** eine vollständige URL eintragen.
3. Speichern.

Auch hier gibt es eine Live-Vorschau mit Shopware-Standard als Fallback.

## Ausgabe im Storefront

Der Canonical-Tag wird automatisch im `<head>` der jeweiligen Seite ausgegeben:

```html
<link rel="canonical" href="…">
```

* Ist ein **eigener Wert** gesetzt, wird dieser verwendet.
* Andernfalls greift die **Standard-SEO-URL** von Shopware.

> **Tipp:** Trage immer die **vollständige URL** inkl. `https://` und Domain ein.
