NewsAgenturJobs
Ditegra GmbH Logo
Leistungen
Lösungen
Case Studies
Knowledge
Kontakt
Termin vereinbaren
  1. Docs
  2. hreflang
Inhaltsverzeichnis
  1. Anleitung zur Konfiguration
  2. Voraussetzungen

PluginDocs

hreflang

Version 5.2.3Kompatibel mit Shopware 6.4 · 6.5 · 6.6 · 6.7Aktualisiert am 14. September 2026Im Shopware Store

Wenn Sie Ihren Shop in mehreren Ländern betreiben, zum Beispiel über shop.de, shop.at und shop.ch, kann es für Google schwierig sein, die passende Version für Besucherinnen und Besucher zu erkennen. Dadurch wird österreichischen Kundinnen und Kunden möglicherweise die deutsche Seite angezeigt. Mit einem hreflang-Tag teilen Sie Google mit, welche Version für welche Sprache oder welches Land vorgesehen ist. Das Plugin erzeugt diese Tags automatisch im Quelltext Ihrer Seiten und in der XML-Sitemap. So helfen Sie Google, die passende Version anzuzeigen und ähnliche Seiten richtig einzuordnen.

Ob Sie das Plugin benötigen, hängt davon ab, wie Ihre Sprachen im Shop organisiert sind. Liegen alle Sprachen innerhalb eines Verkaufskanals, genügen die Shopware-Bordmittel. Verteilen sich Ihre Sprachen oder Länder dagegen auf mehrere Verkaufskanäle und Domains, verknüpft Shopware die Seiten nicht automatisch miteinander. In diesem Fall ist das Plugin die passende Lösung. Zusätzlich können Sie eigene ISO-Codes für Sprach- und Länder-Kombinationen hinterlegen, die Shopware nicht korrekt ableitet. ISO-Codes sind Kürzel für eine Sprache und ein Land, zum Beispiel de-DE für Deutsch in Deutschland oder de-CH für Deutsch in der Schweiz.

Anleitung zur Konfiguration

Installieren und aktivieren Sie das Plugin unter „Meine Erweiterungen“ in Ihrer Shopware-Administration. Gehen Sie danach zu „Konfigurieren“ und nehmen Sie die folgenden Einstellungen vor, um das Plugin zu nutzen:

  • Verkaufskanal: Wählen Sie den Verkaufskanal aus, für den Sie das Plugin aktivieren möchten.

  • Aktiv: Aktivieren Sie das Plugin für den ausgewählten Verkaufskanal.

  • Debug: Nur zum Testen aktivieren. Es werden zusätzliche Ausgaben in der Konsole ausgegeben zur Problembehandlung.

  • Active Verkaufskanäle: Wenn Sie für jeden Verkaufskanal eine Zuweisung vornehmen, achten Sie darauf, immer ALLE betroffenen Verkaufskanäle anzugeben inkl. des aktuell gewählten Verkaufskanals.

Damit ist das Plugin einsatzbereit. Die folgenden Felder steuern, wie und wo die hreflang-Tags ausgegeben werden – prüfen Sie, welche davon für Ihren Shop sinnvoll sind.

  • hreflang-Generierung in der Storefront deaktivieren:Normalerweise schreibt das Plugin die hreflang-Tags direkt in jede Seite Ihres Shops. Schalten Sie dieses Feld ein, wenn Google die Tags ausschließlich über die Sitemap erhalten soll. Bei vielen Verkaufskanälen und Sprachen empfehlen wir genau das, weil es die Ladezeit der Storefront verbessert. Laut der offiziellen Google-Dokumentation sind HTML und Sitemap gleichwertige Methoden zur Implementierung von hreflang. Weitere Informationen
  • hreflang-Generierung in der Sitemap deaktivieren: Dasselbe umgekehrt: Das Plugin trägt die hreflang-Tags dann nicht mehr in die XML-Sitemap ein. Schalten Sie niemals beide Felder gleichzeitig ein – sonst erzeugt das Plugin überhaupt keine hreflang-Tags mehr.
  • hreflang für nicht kanonische Produkt-URLs deaktivieren: Ein Produkt ist in Shopware oft über mehrere Adressen erreichbar, zum Beispiel zusätzlich über einen Kategoriepfad. Mit diesem Feld erhält nur die Hauptadresse des Produkts hreflang-Tags. Das empfehlen wir, damit Google eindeutig erkennt, welche Adresse die richtige ist.
  • Trailing Slashes für die Homepage-Links aktivieren: Betrifft nur die Startseite. Endet deren Adresse bei Ihnen mit einem Schrägstrich (https://shop.de/), sorgt dieses Feld dafür, dass auch die hreflang-Links der Startseite auf einen Schrägstrich enden – die Tags bleiben so einheitlich.
  • x-default verwenden: Legt eine Standardversion für alle Besucher fest, deren Sprache zu keinem Ihrer Verkaufskanäle passt. Beispiel: Jemand aus Spanien besucht Ihren Shop, den es nur auf Deutsch und Englisch gibt – Google zeigt dann die von Ihnen festgelegte Standardversion.
  • x-default: Hier wählen Sie die Domain aus, die diese Standardversion sein soll. Das Feld wirkt nur, wenn „x-default verwenden“ eingeschaltet ist.
  • Benutzerdefinierte ISO-Code-Zuordnungen: Das Plugin ermittelt das Sprachkürzel (z. B. de-CH) automatisch aus Ihren Shopware-Einstellungen. Passt das Ergebnis für eine Domain einmal nicht, können Sie hier ein eigenes Kürzel vorgeben. Schreiben Sie pro Zeile Domain und Kürzel, getrennt durch ein Semikolon, zum Beispiel: example.ch/en;en-ch.
  • Route/Entity-Zuordnung (YAML): Nur nötig, wenn andere Plugins eigene Seitentypen mitbringen, die ebenfalls hreflang-Tags erhalten sollen.

Voraussetzungen


1. Shopware-eigene hreflang-Integration deaktivieren

Wenn Sie das Plugin im Einsatz haben, stellen Sie sicher, dass Sie auf ihren Verkaufskanälen die Shopware hreflang Integration NICHT aktiviert haben. Dafür gehen Sie in den jeweiligen Verkaufskanal in der linken Menüleiste Ihrer Shopware-Administration. Unter dem Reiter „Allgemein“ scrollen Sie nach unten bis zum Bereich „Hreflang“

Die Shopware Default Hreflang Integration greift nur, wenn sich ihre Sprachshops innerhalb eines Verkaufskanals befinden. Verwenden Sie mehrere Verkaufskanäle, ist die Funktion ohne Nutzen - andernfalls bräuchten Sie dieses Plugin nicht :)

2. Sprachen und ISO-Codes prüfen

Damit das Hreflang für die jeweiligen Länder die korrekte Info mitgibt, müssen wir folgende Konfigurationen beachten.:

Sprache:

Unter "Einstellungen" -> "Sprachen" muss für jede Sprache ein korrekter ISO-Code hinterlegt werden, da diese Information vom Plugin gezogen wird.


Name Lokalisierung ISO-Code Erbt von Standard
English Englisch, Vereinigtes Königreich en-GB -
Deutsch - Schweiz Deutsch, Schweiz de-CH Deutsch - Deutschland
Deutsch - Deutschland Deutsch, Deutschland de-DE - ✅

3. Verkaufskanäle und Domains konfigurieren

Auf den gewünschten Verkaufskanal klicken und dann bei "Grundeinstellung" beim Feld "Länder", "Sprachen", "Standard-Land" & "Standard-Sprache" die jeweilige Sprache zum Verkaufskanal auswählen.

Nach diesen Änderungen etwas herunter scrollen bis zum Punkt "Domain", die selbe Sprache auswählen wie es weiter oben bei "Grundeinstellung" ausgewählt ist.

Plugin:

Im Plugin sollte auch der Verkaufskanal mit der gewünschten Sprache auf aktiv gesetzt sein.

Sollten Sie weitere Hilfe benötigen, können Sie auch gerne ein Ticket über den Shopbetreiberbereich einreichen.

Viel Erfolg und Spaß mit der Erweiterung.

Changelog

5.2.3

14.09.2026 · Shopware 6.7.0.0 – 6.7.14.2

  • Unnötige Log-Fehler bei nicht verfügbaren Produktdetailseiten wurden behoben.

4.2.3

14.09.2026 · Shopware 6.6.0.0 – 6.6.10.27

  • Unnötige Log-Fehler bei nicht verfügbaren Produktdetailseiten wurden behoben.

5.2.2

06.08.2026 · Shopware 6.7.0.0 – 6.7.14.2

Verbesserte Performance bei der Generierung von Hreflang-Links für Produktseiten. Informationshinweis in der Plugin-Konfiguration hinzugefügt.

5.2.1

07.07.2026 · Shopware 6.7.0.0 – 6.7.14.2

  1. Behandlung von Dynamic-Access-Regeln vom Typ „Verkaufskanal ist keiner von“ korrigiert.

5.2.0

02.07.2026 · Shopware 6.7.0.0 – 6.7.14.2

  1. Sichtbarkeitsprüfungen für Dynamic Access bei Storefront- und Sitemap-URLs hinzugefügt (Regeltypen Sales Channel und Always Valid).
ditegra

Als zertifizierte Shopware-Agentur unterstützen wir Sie bei Entwicklung, Migration und Optimierung Ihres Onlineshops, von der ersten Planung bis zum laufenden Support.

+49 (0) 7732 890 35 18info@ditegra.deWestendstraße 3
78315 Radolfzell
Friedrich-Werber-Straße 44
78315 Radolfzell

  • Shopware Agentur
  • Shopware Migration
  • Support & Wartung
  • Services
  • Shopware Erweiterungen

  • Xentral Agentur
  • Xentral Erweiterungen
  • Veloconnect Gateway
  • Fahrrad & E-Bike

  • Marketing Agentur
  • SEO / GEO
  • Google Ads
  • Microsoft Ads
  • Comparison Shopping Service (CSS)
  • Affiliate Marketing
  • Conversion-Optimierung
  • Newsletter Marketing

  • Agentur
  • Case Studies
  • Jobs
  • News
  • Knowledge
  • Newsletter
  • Kontakt
#ditegralisiert

Partner & Auszeichnungen

  • Shopware United
  • Shopware Silver Partner
  • Shopware Extension Partner
  • Google Partner
  • Google Comparison Shopping Partner
  • Microsoft Advertising Partner

© 2026 ditegra GmbHImpressumDatenschutz

Realisiert mit Shopware Composable Frontends