E-Mails in der Sprache Ihres Kunden versenden

Eine Kundin in München sollte ihre Bestellbestätigung nicht auf Englisch bekommen, und Sie sollten dafür nicht drei Layouts und drei Workflows pflegen müssen. Ein E-Mail-Layout kann jede Sprache enthalten, in der Sie verkaufen. Ihr Shopify-Flow-Schritt gibt an, welche Sprache ein Kunde spricht, und die App sendet die passende Version. Alle anderen erhalten das Layout in seiner Hauptsprache.

Diese Anleitung führt vom einsprachigen Layout zu E-Mails in der Sprache Ihrer Kunden und erklärt jeden Sonderfall: unbekannte Sprachen, regionale Varianten, spätere Änderungen, Tests und Fehlersuche.

So funktioniert es

Ein Layout hat eine Hauptsprache. Das ist das Layout selbst, also die Version, die Sie heute haben.
Sie fügen Übersetzungen hinzu: Deutsch, Französisch, bis zu 30 pro Layout. Jede hat ihren eigenen Betreff, Vorschautext und Inhalt.
In Shopify Flow hat die Aktion Send Transactional Email ein Feld Language. Tragen Sie dort die Sprache des Kunden ein, zum Beispiel {{order.customerLocale}}.
Beim Versand wählt die App die passende Übersetzung. Gibt es keine, wird die Hauptsprache gesendet. Eine E-Mail wird nie wegen ihrer Sprache blockiert.

Ein Layout, ein Workflow, jede Sprache.

Schritt 1: Eine Sprache hinzufügen

Öffnen Sie das Layout unter Email Layouts.
Klicken Sie oben auf der Seite auf Add language.
Wählen Sie die Sprache unter Language to add und klicken Sie auf Add language.

Die neue Sprache beginnt als Kopie Ihres gespeicherten Layouts und öffnet sich sofort im Editor. Übersetzen Sie Betreff, Vorschautext und Inhalt und klicken Sie auf Save.

Mit einem verbundenen KI-Anbieter können Sie statt einer Kopie Translate with AI wählen. Jeder Text wird übersetzt; Liquid-Tags wie {{ variables.order_name }}, Links und das Design bleiben genau so, wie sie sind. Nichts wird versendet, bevor Sie es geprüft und gespeichert haben. Siehe Layouts mit KI erstellen, bearbeiten und übersetzen.

Der Dialog Add language eines E-Mail-Layouts mit ausgewähltem Deutsch — Add language: Sprache wählen. Sie beginnt als Kopie des Layouts und kann sofort übersetzt werden.

Layouts, die Sie vor den Sprachen erstellt haben

Ein Layout, das vor dieser Funktion entstanden ist, hat noch keine Hauptsprache. Wir haben nie gefragt, in welcher Sprache es geschrieben ist, und wir raten nicht. Wenn Sie einem solchen Layout zum ersten Mal eine Sprache hinzufügen, beginnt der Dialog mit einer zusätzlichen Frage: Main language of this layout.

Nichts ist vorausgewählt. Wählen Sie die Sprache, in der das Layout heute geschrieben ist: Deutsch für ein deutsches Layout.
Language to add und die Schaltfläche Add language bleiben deaktiviert, bis Sie gewählt haben.
Sie werden einmal pro Layout gefragt. Layouts, die Sie ab jetzt erstellen, wählen ihre Sprache schon auf der Erstellungsseite.

Die richtige Angabe ist wichtig: Kunden, für deren Sprache es keine Übersetzung gibt, erhalten die Hauptsprache, und Übersetzungen werden gegen sie abgeglichen.

Der Dialog Add language bei einem Layout aus der Zeit vor den Sprachen: Main language of this layout steht an erster Stelle und ist Pflicht, danach folgt die hinzuzufügende Sprache — Ein Layout aus der Zeit vor den Sprachen fragt zuerst, in welcher Sprache es geschrieben ist. Nichts ist vorausgewählt, und Add language bleibt deaktiviert, bis Sie gewählt haben.

Schritt 2: Im selben Editor übersetzen

Eine Übersetzung öffnet sich in dem Editor, den Sie schon kennen: im visuellen Builder für Builder-Layouts, in Rich Text oder HTML für die anderen. Beim Wechsel der Sprache ändert sich nicht der Bildschirm, nur der Inhalt.

Wechseln Sie mit der Auswahl Language: im visuellen Builder in der Leiste über der Vorschau, in einem Rich-Text-/HTML-Layout oben in der Karte Email content.
Der Eintrag mit (layout) ist die Hauptsprache.

Die deutsche Version eines Rich-Text-Layouts: derselbe Bildschirm, Name und Beschreibung schreibgeschützt, Betreff und Inhalt auf Deutsch — Beim Sprachwechsel bleibt der Bildschirm gleich. Name und Beschreibung sind gemeinsam und hier schreibgeschützt; Betreff, Vorschautext und Inhalt gehören zur Sprache.

Der visuelle Builder mit der deutschen Version einer Bestellbestätigung — Der visuelle Builder funktioniert genauso: Wählen Sie die Sprache in der Leiste über der Vorschau.

Schritt 3: Shopify Flow die Sprache mitteilen

Tragen Sie in der Aktion Send Transactional Email im Feld Language die Flow-Variable ein, die die Sprache Ihres Kunden enthält:

Trigger	Language
Order created, Order paid	`{{order.customerLocale}}`
Customer created	`{{customer.locale}}`
Fulfillment created	`{{fulfillment.order.customerLocale}}`

Für einen Workflow, der nur einen Markt bedient, tragen Sie einen festen Code wie de ein.

Das Feld ist optional. Workflows, die Sie früher gebaut haben, laufen unverändert weiter: Ohne Language senden sie die Hauptsprache, genau wie bisher.

Die Aktion Send Transactional Email in Shopify Flow mit den Feldern Reply-To, From name, Language mit order.customerLocale und Variables — Die Aktion in Shopify Flow: Language erhält die Sprache des Kunden, hier {{order.customerLocale}}. Reply-To und From name sind ebenfalls neu.

Welche Version ein Kunde bekommt

Die App sucht die beste Übereinstimmung, in dieser Reihenfolge:

Die exakte Sprache. fr-CA sendet Ihre Übersetzung fr-ca.
Die Basissprache. de-CH und de-AT senden Ihre Übersetzung de. Eine deutsche Übersetzung deckt Deutschland, Österreich und die Schweiz ab.
Eine regionale Variante. pt sendet Ihre Übersetzung pt-br.
Sonst die Hauptsprache. Das Layout selbst wird gesendet.

Groß- und Kleinschreibung und das Trennzeichen spielen keine Rolle: de-DE, de-de und de_DE sind dasselbe.

Was passiert, wenn es die Sprache nicht gibt?

Nichts geht kaputt. Die E-Mail wird in der Hauptsprache gesendet, wenn:

es für die Sprache des Kunden keine Übersetzung gibt (ein japanischer Kunde, und Sie haben ins Deutsche und Französische übersetzt),
das Feld Language leer ist oder die Flow-Variable für diesen Kunden keinen Wert hat,
der Wert gar keine Sprache ist.

Der Versand wird nie abgelehnt und schlägt nie wegen des Feldes Language fehl. Die einzige Prüfung findet statt, während Sie den Workflow bauen: Wenn Sie einen festen Wert eintragen, der kein Sprachcode ist, etwa english, zeigt Shopify Flow den Hinweis, einen Code wie de, fr oder pt-BR zu verwenden. Flow-Variablen werden immer akzeptiert.

Ein Layout für jede Sprache

Manchmal ist eine ganze Übersetzung mehr, als Sie brauchen: Die E-Mail ist für alle gleich, bis auf einen Satz. Dafür kennt jedes Layout {{ language }}.

{{ language }} ist die Language, die Ihr Flow-Schritt gesendet hat, in Kleinbuchstaben (de, fr, de-at). Sendet der Schritt keine, ist es die Hauptsprache des Layouts. Es funktioniert im Betreff, im Vorschautext und im Inhalt, im visuellen Builder ebenso wie in Rich-Text-/HTML-Layouts und auch innerhalb einer Übersetzung.

{% if language == "de" %}
  <p>Retouren aus Deutschland gehen an unser Lager in Hamburg.</p>
{% else %}
  <p>International returns are refunded within 10 working days.</p>
{% endif %}

Im visuellen Builder gehört das in einen Block HTML / Code. In einem Rich-Text-/HTML-Layout schalten Sie den Inhalt auf HTML um.

Shopify sendet oft eine Region mit der Sprache, etwa de-AT oder en-GB. {{ language }} behält sie (de-at). Vergleichen Sie deshalb nur die ersten beiden Buchstaben, wenn Sie "irgendein Deutsch" meinen:

{% assign lang = language | slice: 0, 2 %}
{% if lang == "de" %}Hallo{% elsif lang == "fr" %}Bonjour{% else %}Hello{% endif %}

{{ language }} ist das, was der Schritt angefragt hat, nicht die Übersetzung, die gefunden wurde. Für einen japanischen Kunden steht dort ja, obwohl die Hauptsprache gesendet wurde. So kann auch ein Layout ganz ohne Übersetzung darauf reagieren. Die Karte System Variables im Editor zeigt die Variable mit ihrem aktuellen Wert und kopiert sie mit einem Klick. Bei einem Layout, das noch keine Hauptsprache hat, bleibt sie leer, bis ein Flow-Schritt eine Language sendet.

Ein HTML-Layout, dessen Inhalt if language gleich de verwendet, neben der Karte System Variables mit der Variable language — {{ language }} in einem Layout: ein Absatz für deutsche Kunden, ein anderer für alle übrigen. Die Karte System Variables zeigt den aktuellen Wert.

Testen, bevor Sie live gehen

Send test email hat eine Auswahl Language, sobald das Layout Übersetzungen hat. Senden Sie sich jede Sprache einmal zu.
Der Test verwendet Ihre Test Variables, keine Live-Daten. Ein echter Workflow-Lauf ist die abschließende Prüfung; siehe Ihr E-Mail-Setup testen.
Um die ganze Kette zu testen, lassen Sie den Workflow für eine Bestellung laufen, deren Kunde die übersetzte Sprache hat.

Prüfen, was gesendet wurde

History hält die Sprache jeder E-Mail fest. Öffnen Sie ein Ereignis: Language unter Event details zeigt die gesendete Übersetzung oder Main language of the layout. Resend sendet dieselbe Sprache erneut.

Ein History-Ereignis einer gesendeten E-Mail mit Status, Dauer und der Sprache German unter Event details — Ein Ereignis in History: Language unter Event details zeigt, welche Version gesendet wurde.

Die Hauptsprache ändern

Ihr Shop hat auf Englisch begonnen, und heute sind die meisten Kunden deutschsprachig? Öffnen Sie die deutsche Übersetzung und klicken Sie auf Set as main language. Deutsch wird zum Layout selbst und Englisch zu einer Übersetzung: Die beiden tauschen die Plätze, und nichts geht verloren. Ab dann erhalten Kunden ohne passende Übersetzung und E-Mails ohne Language die deutsche Version. Über den Versionsverlauf können Sie das rückgängig machen.

Der Dialog Make German the main language, der erklärt, dass die beiden Sprachen die Plätze tauschen — Set as main language: Übersetzung und Layout tauschen die Plätze. Nichts geht verloren, und es lässt sich über den Versionsverlauf rückgängig machen.

Eine Sprache entfernen

Öffnen Sie die Übersetzung und klicken Sie auf Delete gefolgt vom Namen der Sprache, zum Beispiel Delete German. Kunden mit dieser Sprache erhalten ab der nächsten E-Mail die Hauptsprache. Die Übersetzung bleibt im Versionsverlauf des Layouts und kann wiederhergestellt werden. Siehe Layout-Versionsverlauf.

Wenn etwas anders ist als erwartet

Ein Kunde hat die Hauptsprache statt seiner eigenen bekommen. Öffnen Sie die E-Mail in History und sehen Sie sich Language an. "Main language of the layout" bedeutet, dass keine Übersetzung gepasst hat: Das Feld Language des Flow-Schritts ist leer, die Variable hatte für diesen Kunden keinen Wert, oder Sie haben für diese Sprache keine Übersetzung. Prüfen Sie zuerst den Schritt; die Tabelle in Schritt 3 nennt die richtige Variable pro Trigger.

Add language ist ausgegraut. Das Layout hat noch keine Hauptsprache. Wählen Sie zuerst oben im Dialog Main language of this layout.

Die Sprache, die ich brauche, steht nicht in der Liste. Die Liste enthält die häufigsten Sprachen. Jeder gültige Sprachcode lässt sich über die API hinzufügen.

Ich habe das Layout geändert, aber die deutsche E-Mail zeigt noch den alten Text. Übersetzungen sind Kopien. Nehmen Sie die Änderung auch in der deutschen Version vor.

Ich sehe das Feld Language in der Flow-Aktion nicht. Der Schritt wurde vor diesem Update hinzugefügt, und Shopify Flow behält die Felder, mit denen ein Schritt angelegt wurde. Löschen Sie den Schritt Send Transactional Email und fügen Sie ihn neu hinzu: Language steht dann zwischen From name und Variables (JSON).

Über die API

Übersetzungen lassen sich mit GET und PUT /api/v1/email-templates/:id/translations/:locale lesen und schreiben, eine Übersetzung wird mit POST /api/v1/email-templates/:id/translations/:locale/promote zur Hauptsprache, und die MCP-Tools heißen list_template_translations, set_template_translation und promote_template_translation. Jeder gültige Sprachcode wird akzeptiert, bis zu 30 Sprachen pro Layout. Siehe REST-API-Referenz und KI-Assistenten verbinden (MCP).