So importierst du Übersetzungen in Shopify
Geschrieben von Noah Howadt
Zuletzt aktualisiert:
Übersetzungen per CSV in deinen Shopify-Shop zu importieren oder zu aktualisieren klingt einfach. In der Praxis gibt es dabei aber einige typische Stolperfallen. Wenn du eine rohe oder nur grob formatierte Tabelle in Shopify hochlädst, können schnell Importfehler, falsch zugeordnete Felder oder ungültige Locale-Werte entstehen.
In diesem Leitfaden erklären wir, warum CSV-Importe für Übersetzungen häufig scheitern, welche Dateianforderungen Shopify genau stellt und wie du deine Übersetzungen für einen erfolgreichen Import vorbereitest.
Warum CSV-Uploads für Übersetzungen oft fehlschlagen
Shopify erlaubt Shop-Betreiber*innen, mehrsprachige Inhalte per CSV zu exportieren und zu importieren. Das Importformat ist allerdings ziemlich strikt. Schon ein fehlendes Anführungszeichen, eine falsch benannte Spalte oder ein ungültiges Locale kann ausreichen, damit der Upload abbricht.
Häufige Probleme sind:
- Formatierungsfehler: Fehlende Kopfzeilen, falsche Zeichencodierung oder nicht korrekt maskierte Kommas und Anführungszeichen können dazu führen, dass die CSV abgelehnt wird.
- Probleme beim Feld-Mapping: Wenn Ressourcen-IDs oder Feldnamen nicht Shopifys erwarteter Struktur entsprechen, werden Übersetzungen möglicherweise nicht importiert oder landen im falschen Feld.
- Locale-Fehler: Nicht standardisierte ISO-Sprachcodes wie
es_ESstattesoder ein Locale, das in Shopify nicht aktiviert ist, können den Import verhindern.
Shopifys CSV-Struktur für Übersetzungen erklärt
Damit Übersetzungen erfolgreich importiert werden, muss deine CSV-Datei Shopifys Übersetzungs-CSV-Struktur folgen. Unten findest du die sechs erforderlichen Spalten:
| Spaltenüberschrift | Beschreibung | Beispiel |
|---|---|---|
| Type | Ressourcentyp, der übersetzt wird | PRODUCT, COLLECTION, PAGE |
| Identification | Eindeutiger Handle oder die ID der Ressource | leather-jacket-black |
| Field | Das konkrete Attribut, das übersetzt wird | title, body_html, meta_title |
| Locale | ISO-Code der Zielsprache oder Zielregion | fr, de, es |
| Default Content | Originaltext in der Hauptsprache deines Shops | Leather Jacket |
| Translated Content | Die lokalisierte Übersetzung | Veste en cuir |
Hinweis: Shopify erwartet exakt die oben gezeigten Spaltennamen. Groß-/Kleinschreibung und Spaltenreihenfolge sind wichtig.
Wenn du die Datei nicht manuell anpassen möchtest, kannst du Translingos kostenlosen Formatter nutzen, um deine Spalten zuzuordnen und eine Shopify-kompatible CSV zu erzeugen.
Free tool
Musst du eine Übersetzungstabelle vor dem Import korrigieren?
Nutze den kostenlosen Online-Formatter, um deine Spalten zuzuordnen und eine gültige Shopify-Übersetzungs-CSV im Browser herunterzuladen.
Kostenlosen Datei-Formatter öffnenSo bereitest du eine Übersetzungs-CSV vor und importierst sie
Wenn du die Datei selbst in Google Sheets oder Excel vorbereitest, folge diesem Ablauf:
- Exportiere die Originalvorlage aus Shopify Admin > Einstellungen > Sprachen.
- Öffne die Datei in einem Tabellenprogramm und stelle sicher, dass die Zeichencodierung strikt auf UTF-8 gesetzt ist.
- Übertrage deine übersetzten Texte Zeile für Zeile in die Spalte
Translated Content. Achte darauf, dass alle Werte inType,Identification,FieldundLocaleexakt mit Shopifys bestehenden Datensätzen übereinstimmen. - Maskiere Sonderzeichen, HTML-Tags und Zeilenumbrüche korrekt, damit Shopify jede Zeile richtig lesen kann.
- Exportiere die Datei wieder als CSV und lade sie zurück in Shopify hoch.
Warum manuelle Vorbereitung oft länger dauert als erwartet
- Zeitaufwendig: Große Kataloge können Tausende Übersetzungszeilen erzeugen.
- Leicht zu verschieben: Kleine Änderungen in Tabellen können Zeilen verschieben oder übersetzte Inhalte von der richtigen Ressource bzw. dem richtigen Feld trennen.
- Encoding-Probleme: Tabellenprogramme können Sonderzeichen, Akzente oder nicht-lateinische Schriften beim Speichern von CSV-Dateien verändern.
Direkt in Shopify übersetzen
Schluss mit Übersetzungsdateien
Installiere Translingo, um deine Shop-Inhalte direkt in Shopify zu übersetzen, Updates zu automatisieren und weniger manuelle Dateiarbeit zu haben.
Translingo kostenlos installieren