Release Notes in der Praxis

Die Produkt-Update-E-Mail-Vorlage, die gelesen wird

6 Min. Lesezeit aktualisiert am

Die Produkt-Update-E-Mail, die gelesen wird, ist die, die an jemanden geschickt wird, der um genau das gebeten hat, was sie ankündigt. Alles andere konkurriert mit dem Rest des Posteingangs um Interessantheit, ein Wettbewerb, den eine Release-Ankündigung die meisten Wochen verliert. Diese eine Tatsache sollte die Form der E-Mail bestimmen, bevor irgendeine Formulierung entschieden wird: Wer bekommt sie, und was hat diese Person getan, um auf der Liste zu landen.

Was ist eine Produkt-Update-E-Mail?

Es ist eine Nachricht, die bestehenden Nutzern sagt, was sich an einem Produkt geändert hat, das sie schon benutzen. Es gibt vier verschiedene Arten, und sie als eine Liste zu behandeln ist, warum Öffnungsraten verfallen. Jede hat einen anderen Auslöser, ein anderes Publikum und eine andere akzeptable Häufigkeit.

ArtAuslöserPublikumHäufigkeit
Gezielte BenachrichtigungJemandes konkrete Anfrage wurde ausgeliefertEine PersonWann immer es passiert
Breaking-Change-HinweisEine Änderung, die den Leser Arbeit kostetNur betroffene AccountsWann immer es passiert
DigestZeitablaufOpt-in-NutzerHöchstens monatlich
Launch-AnkündigungEin Launch, der eine Unterbrechung wert istSegment oder alleSelten, und sollte selten wirken

Die meisten Teams bauen nur die dritte, schicken sie an alle, und schließen daraus, dass Produkt-Update-E-Mails nicht funktionieren. Die ersten beiden tragen fast den ganzen Wert, weil der Leser einen vorherigen Grund hat, sich zu interessieren, und die Nachricht ankommt, während dieser Grund lebendig ist.

Alle vier Zeilen hier sind für Kundinnen geschrieben. Vertrieb, Support und Customer Success müssen auch wissen, was ausgeliefert wurde, meist in einer anderen Form als jede dieser vier; interne Release Notes behandelt, was dieses Dokument sagen sollte und warum es vor der kundenseitigen Notiz rausgehen muss.

E-Mail ist einer von mehreren Kanälen, die eine Launch-Ankündigung nutzen kann, nicht der einzige. Wie man ein neues Feature ankündigt behandelt die anderen, und wie man je nach Größe des Features zwischen ihnen wählt.

Was gehört in die Vorlage?

Sechs Blöcke, in dieser Reihenfolge. Der erste ist der, der meist fehlt, und der, der die Arbeit leistet.

Betreff:  <was sich geändert hat, in den Worten des Lesers>

1. Warum du das bekommst
   "Du hast im März nach CSV-Export gefragt." oder
   "Deine Integration ruft /v1/invoices auf, das sich am 15. Januar ändert."

2. Was sich geändert hat
   Ein Satz. Was jetzt möglich ist, oder was jetzt bricht.

3. Was du tun musst
   Oft "nichts". Sag es explizit, statt es implizit zu lassen.

4. Wo man es sieht
   Ein Link zum Changelog-Eintrag, nicht zur Startseite.

5. Wann
   Das Datum, an dem es ausgeliefert wurde, oder ab wann es gilt.

6. Wie man das abbestellt
   Ein Klick, und sofort respektiert.

Block 1 ist der Unterschied zwischen einer Nachricht und einer Rundsendung. Ein Leser, dem in der ersten Zeile gesagt wird, dass dies die Auflösung von etwas ist, das er persönlich angestoßen hat, liest den Rest. Ohne ihn sind Blöcke 2 bis 5 ein Newsletter, egal wie gut geschrieben.

Haltet das Ganze unter etwa 150 Wörtern. Die E-Mail ist ein Verweis auf den Changelog-Eintrag, und der Eintrag ist, wo Detail hingehört. Eine E-Mail, die den ganzen Eintrag wiederholt, gibt dem Leser keinen Grund zu klicken und euch kein Signal, ob es jemanden interessiert hat.

Welche Betreffzeilen funktionieren?

Nennt die Änderung, nicht das Release. “CSV-Export ist live” schlägt “September-Produkt-Update”, weil ersteres eine Tatsache ist, die der Leser bewerten kann, und letzteres ein Container. Versionsnummern in der Betreffzeile sind für Aufrufer einer API nützlich und für alle anderen Rauschen, ein weiterer Grund, die Publika zu trennen.

Vermeidet es, einen Nutzen zu behaupten, dem der Leser nicht zugestimmt hat. “Deine Reports sind jetzt schneller” behauptet etwas über seine Erfahrung; “Reports über 10.000 Zeilen laden jetzt in unter einer Sekunde” berichtet eine Änderung und lässt ihn entscheiden, ob sie zählt.

Wann sollte man eine schicken, und an wen?

Schickt eine gezielte Benachrichtigung in dem Moment, in dem die Sache ausgeliefert wird, an die Leute, die gefragt haben, einzeln. Schickt einen Breaking-Change-Hinweis, sobald das Datum sicher ist, und nochmal kurz davor, an die tatsächlich betroffenen Accounts statt an die ganze Liste. Schickt ein Digest nur, wenn ihr genug Änderungen habt, dass ein Leser sonst etwas verpassen würde, und lasst Leute sich separat dafür eintragen.

Die Liste, die man fast nie nutzen sollte, ist “alle Nutzer”. Sie macht aus einer konkreten Nachricht eine generische, und trainiert das Abbestellen. Segmentiert nach Verhalten, das ihr schon speichert: wer das angefragt hat, wer diesen Endpunkt nutzt, wer auf diesem Plan ist.

Braucht man Einwilligung dafür?

Für bestehende Kunden ist ein Update zu einem Dienst, den sie nutzen, meist eine andere rechtliche Frage als Marketing an einen Interessenten, und die Antwort hängt davon ab, wo sie sind und was ihr ihnen bei der Anmeldung gesagt habt. In der EU ist die relevante Frage, welche Rechtsgrundlage nach Artikel 6 der DSGVO greift, und in den USA gelten für kommerzielle Nachrichten die Vorgaben aus dem CAN-SPAM-Leitfaden der FTC. Beide stellen dieselbe praktische Forderung: sagt, wer ihr seid, macht den Zweck klar, und lasst Leute aufhören können.

Haltet transaktionale und Marketing-Streams auf Versandebene getrennt, unabhängig von der Rechtsgrundlage. Ein Breaking-Change-Hinweis, den ein Kunde abbestellt hat, weil er sich eine Liste mit einem Werbe-Digest geteilt hat, ist ein Support-Vorfall, der auf sein Datum wartet.

Wie sieht das ausgefüllt aus?

Die gezielte Benachrichtigung, die wertvollste Produkt-Update-E-Mail und die, die die meisten Teams nie bauen:

Betreff: CSV-Export ist live

Hi Dana,

du hast im März CSV-Export angefragt.

Es ist heute Morgen live gegangen. Reports haben jetzt einen
Export-Button, der eine CSV der aktuellen Ansicht erzeugt,
Filter eingeschlossen.

Nichts zu tun auf deiner Seite. Es ist schon für deinen Account an.

  Details: example.com/changelog#csv-export
  Ausgeliefert: 2. September 2026

Du bekommst das, weil du danach gefragt hast. Anfrage-Updates
abbestellen: <link>

Neunzig Wörter, und der Leser erfährt in der ersten Zeile, warum das ankam. Vergleicht das mit derselben Änderung in einem monatlichen Digest, wo sie als ein Punkt von neun erscheint und Dana keinen Grund hat zu bemerken, dass ihre eigene Anfrage rausging.

Was sollte man messen?

Nicht die Öffnungsrate allein. Bei einer gezielten Benachrichtigung ist die Frage, ob die Person, die gefragt hat, zurückkam und die Sache benutzte, also ist die Zahl, die man beobachten sollte, der Klick zum Eintrag und ob das Feature bei diesem Account innerhalb einer Woche genutzt wird. Bei einem Breaking-Change-Hinweis ist es Abdeckung: welcher Anteil betroffener Accounts hat vor dem Datum geöffnet, und mit wem habt ihr einzeln nachgefasst.

Ein Digest ist der einzige der vier, bei dem eine Öffnungsrate viel bedeutet, und selbst dort ist sie als Trend gegen die eigene Historie nützlicher als gegen einen Branchen-Benchmark. Verschiedene Arten von Produkt-Update-E-Mails haben verschiedene Aufgaben, also beschreibt eine gemittelte Zahl über alle hinweg nichts, worauf man handeln könnte.

Wie unterscheidet sich das von Release Notes?

Release Notes sind ein Dokument, das verfügbar bleibt. Die E-Mail ist ein Zustellmechanismus, der einmal passiert. Dieselbe Änderung erzeugt beides, und die E-Mail sollte kürzer sein als der Eintrag, auf den sie verweist. Release Notes Best Practices behandelt das Dokument, und Changelog vs. Release Notes behandelt, welches ihr gerade schreibt.

Die Beziehung, die es zu treffen gilt: Der Changelog-Eintrag ist der kanonische Text, und die E-Mail zitiert ihn. Wenn diese zwei auseinanderdriften, findet der Leser, der klickt, eine andere Beschreibung der Änderung und traut keinem von beiden mehr. Den Eintrag zuerst zu veröffentlichen und die E-Mail daraus zu erzeugen entfernt die Drift konstruktiv. changeloop funktioniert auf seiner Seite genauso: Ein Eintrag wird einmal geprüft und im Feed, im Widget und auf der gehosteten Seite veröffentlicht, und die Person, die ihn über das Widget angefragt hat, wird auf dem GitHub-Issue informiert, zu dem ihr Feedback wurde, und im Widget selbst. changeloop verschickt die E-Mail nicht; euer E-Mail-Tool zitiert den veröffentlichten Eintrag.

FAQ

Wie oft sollte eine Produkt-Update-E-Mail rausgehen? So oft es etwas gibt, das der Empfänger konkret wissen will, was für eine gezielte Benachrichtigung “immer wenn seine Anfrage ausgeliefert wird” ist und für ein Digest höchstens monatlich.

Sollte die E-Mail den ganzen Changelog-Eintrag enthalten? Nein. Ein Satz und ein Link. Der Eintrag ist die kanonische Version, und eine vollständige Kopie in der E-Mail bedeutet zwei Texte, die übereinstimmen müssen.

Welche Öffnungsrate sollte ich erwarten? Vergleicht jede Art mit sich selbst, statt mit einem Branchen-Benchmark. Eine gezielte Benachrichtigung und ein monatliches Digest sind verschiedene Produkte, und sie zu mitteln versteckt die einzige Zahl, die man beobachten sollte.

Braucht man eine separate Liste für Breaking Changes? Ja, und es sollte die sein, von der Leute sich nicht beiläufig abmelden können, ohne die Konsequenz zu verstehen, weil es die ist, die sie einen Ausfall kostet.


Die technischen Aussagen in diesem Artikel wurden nicht unabhängig geprüft. Wenn etwas nicht stimmt, sagen Sie es uns, und wir korrigieren es.

Mehr bei changeloop: Changelog-Beispiele, Entwicklerdokumentation

changeloop
Das Team hinter einem Changelog, das den Kreis schließt. Ihre Nutzer fragen, Ihr Team liefert, und wer gefragt hat, erfährt davon.