Zum Inhalt springen

Ungültige Sprachangabe: Den richtigen Sprachcode im lang-Attribut setzen

Ihr Shop gibt eine Sprache an, aber mit einem Code, den Browser und Screenreader nicht kennen. Dann ist die Angabe so gut wie keine – richtig wäre schlicht „de“.

  • Schweregrad: Hoch
  • WCAG 3.1.1 · Stufe A
  • Prüft BarriereCheck automatisch

ca. 4 Minuten Lesezeit Stand:

Was das Problem ist

Das lang-Attribut erwartet einen genormten Sprachcode: „de“ für Deutsch, „en“ für Englisch, wahlweise mit Land, etwa „de-DE“ oder „de-AT“. Steht dort etwas anderes, ignorieren Hilfsmittel die Angabe und raten die Sprache selbst.

Typische Fehler sind ausgeschriebene Namen wie „deutsch“, ein Unterstrich statt Bindestrich wie in „de_DE“ oder Platzhalter aus Vorlagen, die nie ersetzt wurden. Oft stammen sie aus einem fest eingetragenen Wert im Theme oder aus einer falsch eingestellten Mehrsprachigkeits-Erweiterung.

Was der Report dazu sagt

Wortlaut aus Ihrem BarriereCheck-Report
Was ist das Problem?
Die Sprachangabe der Seite ist ungültig.
Warum ist das wichtig?
Ein ungültiger Sprachcode führt zu falscher Aussprache im Screenreader.
So beheben Sie es
Verwenden Sie einen gültigen Sprachcode im lang-Attribut, z. B. "de" oder "de-DE".

Wen es betrifft

  • Blinde Menschen – Ihr Screenreader wählt womöglich die falsche Stimme und liest Deutsch mit fremder Aussprache vor.
  • Menschen mit Leseschwäche – Vorlesefunktionen im Browser stolpern über dieselbe Angabe.
  • Kundschaft aus dem Ausland – Übersetzungsfunktionen erkennen die Ausgangssprache schlechter.

Gültige und ungültige Sprachcodes

So besser nicht

  • lang="deutsch"Ausgeschriebener Name statt Code.
  • lang="de_DE"Unterstrich statt Bindestrich.
  • lang="{{ locale }}"Platzhalter aus der Vorlage, nie ersetzt.

So ist es hilfreich

  • lang="de"Deutsch.
  • lang="de-DE"Deutsch für Deutschland.
  • lang="de-AT"Deutsch für Österreich.

So beheben Sie es in Ihrem Shopsystem

  • Shopify

    Wo beheben: Admin, Theme-Code

    Einstellungen → Sprachen prüfen; in layout/theme.liquid keinen festen, falschen Wert für lang eintragen.

    Alle Probleme in Shopify
  • WooCommerce

    Wo beheben: Admin, Plugin

    Einstellungen → Allgemein → Sprache der Website prüfen. Mehrsprachigkeits-Plugins (WPML, Polylang) auf korrekte Sprachcodes einstellen.

    Alle Probleme in WooCommerce
  • Shopware

    Wo beheben: Admin, Theme-Code

    Einstellungen → Sprachen und die Domain-Sprache des Verkaufskanals prüfen; im Theme keinen festen, falschen lang-Wert setzen.

    Alle Probleme in Shopware

Die Menüpfade beziehen sich auf die deutsche Oberfläche und die Standard-Themes. Eigene Themes, Apps und Plugins können abweichen.

Was WCAG und BFSG dazu sagen

WCAG 3.1.1 „Sprache der Seite“, Stufe A: Die Hauptsprache jeder Seite muss so angegeben sein, dass Hilfsmittel sie auslesen können. Ein ungültiger Code erfüllt das nicht.

Das Barrierefreiheitsstärkungsgesetz (BFSG) verweist über die europäische Norm EN 301 549 auf WCAG 2.1 Stufe AA. Kriterium 3.1.1 gehört zu Stufe A und ist damit enthalten.

Allgemeiner Überblick, keine Rechtsberatung. Kriterium beim W3C (englisch)

Häufige Fragen

„de“ reicht. Wer das Land mitgeben will, schreibt „de-DE“, „de-AT“ oder „de-CH“ – immer mit Bindestrich.

Weiterlesen

Kostenloser Test

Prüfen Sie, ob Ihr Shop betroffen ist

Der Test prüft kostenlos die Sprachangabe auf jeder Seite Ihres Shops. Sie brauchen dafür nur die Adresse Ihres Shops.

  • Ergebnis in etwa 3 Minuten
  • Nichts zu installieren – wir prüfen Ihren Shop von außen
  • Probleme nach Dringlichkeit sortiert

Kostenlos · bis zu 3 Seiten ohne Anmeldung · mit Konto bis zu 10 Seiten