> 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/faq-fuer-seo/faq-seite-seo.md).

# FAQ-Seite & SEO

## FAQ-Übersichtsseite

Das Plugin stellt eine eigene FAQ-Seite bereit, standardmäßig unter `https://ihre-domain.de/faq`. Den Pfad können Sie in der [Plugin-Konfiguration](/faq-fuer-seo/konfiguration.md) ändern (Feld **FAQ-Url Pfad**).

Auf der Seite erscheinen:

* optional eine **Überschrift (h1)** und ein **Beschreibungstext** (siehe [Plugin-Konfiguration](/faq-fuer-seo/konfiguration.md))
* alle **aktiven Gruppen** des aktuellen Verkaufskanals, sortiert nach Gruppen-Position
* darunter jeweils die **Fragen** der Gruppe, sortiert nach Frage-Position, zum Auf- und Zuklappen

Nicht angezeigt werden inaktive Gruppen, Gruppen mit **Nur für Kategorie/Artikel** und Fragen ohne Gruppe.

Optional kann die Liste **zweispaltig** dargestellt werden. Ein Link zur FAQ-Seite kann automatisch im **Footer** ausgegeben werden.

<figure><img src="https://4079068400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4TRaEjMdwEGxIbpj8Eey%2Fuploads%2Fgit-blob-31abe0e39e56b3165542b4c6d01728efeafa9b8d%2Fsw6-plugin-seo-faq-storefront-faq-seite.webp?alt=media" alt="FAQ-Übersichtsseite mit Überschrift, Beschreibung und Gruppen"><figcaption><p>FAQ-Übersichtsseite mit Überschrift, Beschreibung und Gruppen</p></figcaption></figure>

## Eigene Seite pro Frage

Jede Frage erhält eine eigene URL, die aus dem Fragetext erzeugt wird:

| Frage                           | URL                                       |
| ------------------------------- | ----------------------------------------- |
| Wie lange dauert der Versand?   | `/faq/wie-lange-dauert-der-versand`       |
| Welche Größen gibt es für Hüte? | `/faq/welche-groessen-gibt-es-fuer-huete` |

Umlaute werden umgeschrieben (ä → ae, ö → oe, ü → ue, ß → ss), Sonderzeichen entfernt und Leerzeichen durch Bindestriche ersetzt.

Auf der Frageseite wird die gesamte FAQ angezeigt, die aufgerufene Frage ist geöffnet. Für die Frageseite gelten eigene **Meta-Daten**:

| Meta-Angabe      | Quelle                                                                                  |
| ---------------- | --------------------------------------------------------------------------------------- |
| Seitentitel      | **Meta Title** der Frage, sonst der Fragetext                                           |
| Meta-Description | **Meta Description** der Frage, sonst die Meta-Description aus der Plugin-Konfiguration |
| Meta-Keywords    | **Keywords** der Frage                                                                  |
| Canonical        | URL der Frage selbst                                                                    |

Die Übersichtsseite verwendet den **Meta Title** und die **Meta Description** aus der [Plugin-Konfiguration](/faq-fuer-seo/konfiguration.md).

> **Hinweis:** Alte Frage-URLs aus Plugin-Versionen vor 4.2.0, bei denen Umlaute entfernt statt umgeschrieben wurden (z. B. `/faq/hufig-gestellte-frage`), werden per **301-Weiterleitung** auf die neue URL umgeleitet.

<figure><img src="https://4079068400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4TRaEjMdwEGxIbpj8Eey%2Fuploads%2Fgit-blob-ea1e10e969264b54cf2234d2920b1aa8de587df7%2Fsw6-plugin-seo-faq-storefront-frageseite.webp?alt=media" alt="Frageseite: die aufgerufene Frage ist geöffnet"><figcaption><p>Frageseite: die aufgerufene Frage ist geöffnet</p></figcaption></figure>

## Sitemap

Die FAQ-Übersichtsseite und alle Frageseiten werden automatisch in die **Sitemap** von Shopware aufgenommen, jeweils mit der Änderungshäufigkeit „monthly“. Berücksichtigt werden aktive Gruppen des jeweiligen Verkaufskanals (bzw. aller Verkaufskanäle), ohne Gruppen mit **Nur für Kategorie/Artikel**.

## Strukturierte Daten (Schema.org)

Auf allen Seiten mit FAQs gibt das Plugin strukturierte Daten vom Typ **`FAQPage`** im JSON-LD-Format aus. Suchmaschinen wie Google können Fragen und Antworten damit direkt in den Suchergebnissen darstellen.

| Seite                                   | Enthaltene Fragen                                                                           |
| --------------------------------------- | ------------------------------------------------------------------------------------------- |
| FAQ-Übersichtsseite                     | alle dort sichtbaren Fragen                                                                 |
| Frageseite                              | nur die aufgerufene Frage                                                                   |
| Kategorie-/Artikelseite mit FAQ-Element | alle Fragen der FAQ-Elemente auf der Seite (auch Gruppen mit **Nur für Kategorie/Artikel**) |

Beispiel:

```json
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Wie lange dauert der Versand?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "<p>In der Regel <strong>1–3 Werktage</strong>.</p>"
      }
    }
  ]
}
```

Das JSON-LD steht im Quelltext der Seite am Ende des `<body>`. Prüfen können Sie es z. B. mit dem [Test für Rich-Suchergebnisse](https://search.google.com/test/rich-results) von Google.