# SEO URL Manager

{% hint style="info" %}
**Du möchtest mehr organischen Traffic?**

Dann schau auf jeden Fall in unserem [SEO-Ratgeber](https://atloss.de/ratgeber/shopware-6-seo/) vorbei! In diesem Beitrag findest du alle wichtigen Shopware 6 SEO Maßnahmen für deinen Shop.
{% endhint %}

### Basiskonfiguration

1. Begebe dich in deinem Admin zu "Erweiterungen" > "Meine Erweiterungen". 
2. Installiere und aktiviere die App.
3. Öffne die Konfiguration und aktiviere die gewünschten Funktionen.
4. Leere den Cache unter "Einstellungen" > "System" > "Caches & Indizes" > "Caches leeren"

### Varianten URLs generieren

1. Begebe dich zu "Einstellungen" > "Shop" > "SEO"
2. Füge folgendes Template in das Feld "Produktdetailseite" ein und speichere deine Eingaben:

{% code title="Produktdetailseite" fullWidth="false" %}

```twig
{{ product.translated.name|lower }}{% if product.variation is not empty and product.parentId is not empty %}{% for var in product.variation %}-{{ var.option|lower }}{% endfor %}{% endif %}/
```

{% endcode %}

{% hint style="success" %}
Dieses Template erstellt die URLs nach folgendem Schema:

*<https://www.shop.de/\\[produkt-name-in-kleinbuchstaben]-\\[variante(n)-in-kleinbuchstaben]/>*
{% endhint %}

Du kannst die Vorlage selbstverständlich noch an deine Bedürfnisse anpassen.

3. Aktualisiere deinen Index unter "Einstellungen" > "System" > "Caches & Indizes" > "Indizes aktualisieren".

{% hint style="info" %}
Den aktuellen Stand der Indexierung kannst du in den Mitteilungen rechts oben verfolgen. Je mehr Produkte du in deinem Shop hast, desto länger kann dieser Prozess dauern.
{% endhint %}

### Sitemap URLs

{% hint style="info" %}
Solltest du den Index im vorherigen Schritt bereits aktualisiert haben, brauchst du dies nicht erneut zu tun.
{% endhint %}

Aktualisiere deinen Index unter "Einstellungen" > "System" > "Caches & Indizes" > "Indizes aktualisieren".

### Canonical URLs

Hierfür ist keine weitere Konfiguration nötig.

### Weitere Optionen

Globale Einstellungen aus der App Konfiguration wie die Verlinkung aus Produkt Boxen, sowie die Canonical-URL Setzung kannst du unter "Kataloge" > "Produkte" > "\[Produkt]" > "Spezifikationen" > "Zusatzfelder" > "Produkt (SEO URL Manager)" auf Produktebene überschreiben.

### FAQ's

<details>

<summary>Meine Listing URLs zeigen nach der Installation der Erweiterung immer noch nicht auf den Parent?</summary>

Da die Erweiterung auf das Listing Template zugreift, kann es vorkommen, dass dein Theme unser Listing Template überschreibt. Sollte dies bei dir der Fall sein, melde dich gerne bei uns und wir lösen das Problem gemeinsam.

</details>

<details>

<summary>Manche Varianten URLs haben nach der Index Generierung eine /detail/3d951aa1fa4549579670c84bb67e5f08 URL. Woran liegt das?</summary>

Diese kryptische URL ist der Shopware 6 Fallback für bereits existierende URLs. Stelle also sicher, dass dein SEO URL Template auf jeden Fall einzigartige und eindeutige URLs generiert. Hast du bspw. zwei Produkte mit dem exakt selben Namen ist die Wahrscheinlichkeit sehr hoch, dass zweimal ein und dieselbe URL generiert wird.

</details>

<details>

<summary>Warum wird auf der Produkt Detailseite die falsche Variante ausgewählt, wenn ich über die App global aus allen Produkt Boxen auf den Parent Artikel verlinke?</summary>

Die Verlinkung auf den Parent aus der Produkt Box ist auch im Shopware Standard möglich. So lässt sich im Produkt im Tab "Varianten" über die Storefront-Darstellung in der Produktliste die Variante definieren, die ausgewählt werden soll, wenn man auf das Hauptprodukt klickt.

Ist dies nicht definiert, handelt das System hierbei nach eigenem Ermessen und wählt selbst eine Variante, da Shopware auf Produkt Detailseiten immer mit einer Vorauswahl arbeitet. Schließlich ist das Hauptprodukt nicht kaufbar.

Der SEO URL Manager linkt daher aus Produkt Boxen über die aktive Konfiguration global immer auf den Parent, es wurde jedoch auf Produktebene nie definiert, was bei Aufruf der Parent-URL ausgewählt werden soll.

Gerade wenn Produkte nach Farben im Listing aufgefächert werden, verlinken dennoch alle Produkte auf den Parent und eine konkrete Vorauswahl nach der entsprechenden Farbe kann aufgrund dieses Konflikts nicht mehr gewährleistet werden. Die Entscheidung zwischen besserer Usability oder SEO Grundstruktur muss dabei jeder für sich selbst entscheiden.

</details>


---

# Agent Instructions: 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.atloss.de/seo-url-manager.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.