Dokumentationsmenü

Referenz des Block-Markups

Diese Seite zeigt, was jeder interaktive Block in das versendete HTML schreibt und wie die Antwort eines Empfängers zu MailInApp gelangt. Sie richtet sich an Entwickler und an alle, die HTML exportieren, um es über eine andere Plattform zu versenden. Die Seite jedes Blocks beschreibt, was Empfänger sehen und was Sie zurückbekommen. Die Stufen selbst erklärt So funktionieren Fallbacks.

Die Beispiele sind gekürzt: Die echte Ausgabe enthält mehr Inline-Styles, ein oder zwei Dark-Mode-Klassen und die Farben Ihres Themes. Jeder Link zeigt auf das signierte Live-Ansicht-Token des Empfängers (/v/[token]), das die E-Mail und, bei einem personalisierten Versand, den Empfänger erkennt.

So werden Antworten erfasst

Zwei Wege führen zum selben Erfassungs-Endpunkt und erzeugen dasselbe Ereignis. Die Ergebnisse hängen also nie davon ab, wo ein Empfänger geantwortet hat.

  • Bestätigungslinks. Eine Antwort mit einem Tap ist ein <a href> auf /v/[token]/act mit Block, Aktion und Wert in der Query. Die geöffnete Seite bittet den Empfänger um Bestätigung, und erst das bestätigende Formular-POST erfasst die Antwort. Ein bloßes GET erfasst nichts, daher können Link-Scanner und Sicherheitswerkzeuge, die jeden Link vorab abrufen, nicht abstimmen. Siehe Scanner-sichere Interaktionserfassung.
  • Formular-POSTs. Ein Block mit getippten oder mehreren Antworten versendet ein <form method="post">, das als application/x-www-form-urlencoded an /api/interactions sendet. Gmail im Web und die Outlook-Apps für iOS und Android senden es direkt aus der E-Mail. Jedes solche Formular trägt außerdem einen immer sichtbaren Link Im Web antworten zum selben Block in der Live-Ansicht, wo es ein gewöhnliches Webformular ist.

Die Antwort eines Empfängers wird einmal pro E-Mail, Block und Empfänger gespeichert, unter einer Dokument-ID aus diesen drei Teilen. Ein wiederholter Tap oder ein erneut geladenes Formular ändert daher nichts. Antworten aus einer exportierten E-Mail ohne Empfänger-Token haben keine Person als Schlüssel und werden stattdessen pro IP, pro Kampagne und pro Minute begrenzt.

Feedback-Blöcke

Umfrage

Jede Option ist ein Bestätigungslink im Stil eines Chips. Er ist immer sichtbar, in jeder E-Mail-App.

<div id="em-poll-1" style="margin:12px 0;background-color:transparent">
  <p style="margin:0 0 10px;font-weight:600;font-size:16px;color:#111827">Which do you prefer?</p>
  <div>
    <a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=poll-1&blockType=poll&action=vote&option=Option+A&optionId=poll-option-2"
       style="display:inline-block;margin:0 6px 6px 0;padding:8px 14px;border:1px solid #d1d5db;border-radius:6px;background-color:#ffffff;color:#111827;font-size:14px;text-decoration:none">
      Option A
    </a>
    <a href="...option=Option+B&optionId=poll-option-3" ...>
      Option B
    </a>
  </div>
</div>

Mit Mehrere Antworten erlauben versendet die Umfrage ein Formular mit Kontrollkästchen, das pro angekreuzter Option eine optionId sendet (gespeichert als parallele Listen option und optionId), dazu den Link Im Web antworten. Eine Option Sonstiges ist ein Link zur Umfrage in der Live-Ansicht, wo der Empfänger seine Antwort eintippt. Die Reihenfolge einer gemischten Umfrage leitet sich aus dem Token des Empfängers ab und ist daher bei jedem Öffnen gleich. Das Live-Ergebnisbild ist ein <img> von /api/results-image, signiert pro Umfrageoption, nie pro Empfänger.

Skalenfrage

Die Standardanzeige Sterne versendet einen Bestätigungslink pro Stern, den höchsten zuerst, in einer Reihe von rechts nach links. Jeder Link enthält einen leeren und einen gefüllten Stern; eine :hover-Regel füllt die Sterne bis zum Zeiger, wo die App es unterstützt, und überall sonst erscheinen die leeren Sterne. Die Sternbilder kommen von /api/rating-icon.

<div id="em-rating-1" style="margin:12px 0;background-color:transparent">
  <p style="margin:0 0 10px;font-weight:600;font-size:16px;color:#111827">How did we do?</p>
  <div dir="rtl" style="direction:rtl;text-align:left;line-height:0">
    <a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=rating-1&blockType=rating&action=rate&rating=5"
       class="em-rating-1-s" aria-label="5 out of 5 stars" style="display:inline-block;padding:6px;line-height:0">
      <img src="https://mailinapp.com/api/rating-icon?f=0&c=f59e0b&s=32" alt="5★" width="32" height="32" class="em-rating-1-o">
      <!--[if !mso]><!-->
      <img src="https://mailinapp.com/api/rating-icon?f=1&c=f59e0b&s=32" alt="" width="32" height="32" class="em-rating-1-f" style="display:none">
      <!--<![endif]-->
    </a>
    <!-- …ein Link pro Stern, bis rating=1 -->
  </div>
</div>

Jede andere Anzeige (Emoji-Gesichter, Daumen, nummerierte Skala, NPS und die klassischen Stern-Chips) ist eine Reihe von Bestätigungslinks mit rating=<n>. Liegt der Wert bei oder unter der Nachfrage-Grenze des Blocks, führt die Bestätigungsseite weiter zu /v/[token]/followup.

Quiz

Das Quiz versendet ein Formular mit einer Radio-Gruppe pro Frage, das q0, q1 … (die angelegte Position der Frage) an /api/interactions sendet, dazu den Link Im Web antworten.

<div style="margin:12px 0;background-color:transparent">
  <p style="margin:0 0 10px;font-weight:700;font-size:18px;color:#111827">
    Test your knowledge!
  </p>
  <!-- <form method="post" action="https://mailinapp.com/api/interactions">:
       eine Radio-Gruppe pro Frage und ein Button "See my score" -->
  <p style="margin:8px 0 0;font-size:13px;text-align:center">
    <a href="https://mailinapp.com/v/eyJhbGci...#em-quiz-1">Answer on the web</a>
  </p>
</div>

Die Auswertung geschieht auf dem Server, anhand des Lösungsschlüssels in der gespeicherten E-Mail; eine von einem Client gesendete Punktzahl wird nie übernommen. Der Wert des Ereignisses ist {answers, score, total, bucket} bei einem Quiz mit Punkten und {answers, outcome, outcomeTitle} bei einem Persönlichkeitsquiz. Mit Sofort zeigen, ob es richtig ist trägt das Label jeder Antwort einen versteckten Hinweis, den eine :checked-Regel einblendet, der Lösungsschlüssel steht also im versendeten HTML. Ein Startbildschirm hält die Fragen in der Live-Ansicht hinter einem :target-Anker.

Formular

Ein einseitiges Formular versendet alle Felder in einem <form>, das an /api/interactions sendet, dazu den Link Im Web antworten.

<div id="em-form-1" style="margin:12px 0;background-color:transparent">
  <!-- <form method="post" action="https://mailinapp.com/api/interactions">:
       alle Felder und ein Absende-Button -->
  <p style="margin:8px 0 0;font-size:13px;text-align:center">
    <a href="https://mailinapp.com/v/eyJhbGci...#em-form-1">Answer on the web</a>
  </p>
</div>

Ein mehrseitiges Formular versendet keine Felder, nur einen Link im Stil eines Buttons mit seiner Beschriftung des Start-Buttons, der zum Befragungsassistenten unter /v/[token]/form/[blockId] führt. Jede Seite dort speichert einen Entwurf (eine Aktion form-page, die keine Ergebnisse und keine Webhooks berührt), und das submit der letzten Seite macht aus dem Entwurf die Antwort. Mit Schritte in der E-Mail werden die Seiten als ein Radio pro Seite vor dem Formular versendet, mit :checked-Regeln, die jeweils eine Seite zeigen; Apps ohne diese Regeln zeigen alle Seiten. Ein Dateifeld verlinkt auf die Live-Ansicht, da sich eine Datei nur aus einem Browser hinzufügen lässt. Bedingte Fragen erscheinen im versendeten Formular alle; der Server verwirft die Antworten auf Fragen, die die früheren Antworten des Empfängers ausblenden.

Der Server prüft jede Antwort gegen das Formular in der gespeicherten E-Mail, bevor er etwas schreibt. Ein Browser, der eine ungültige Antwort gesendet hat, wird zu /v/[token]?invalid=<fieldId>&why=<problem> zurückgeschickt, und ein JSON-Aufrufer erhält ein 400 invalid-answer.

Shop- und Bewertungsblöcke

Links in diesen Blöcken laufen über /v/[token]/click, das den Klick erfasst und zum Ziel weiterleitet. Wiederholungen desselben signierten Links innerhalb von fünf Minuten zählen einmal.

Countdown

Der Countdown ist ein einziges <img> von /api/countdown. Seine URL ist über Ende und Farbe signiert, und jeder Abruf zeichnet aus der Restzeit ein neues GIF mit 60 Bildern, eines pro Sekunde, das danach auf seinem letzten Bild stehen bleibt. Identische signierte Anfragen teilen sich bis zu zehn Sekunden lang ein Rendering. Der alt-Text enthält die Restzeit in Worten, für Screenreader und für Apps, die Bilder spät laden.

<div style="margin:12px 0">
  <p style="margin:0 0 6px;font-size:16px;font-weight:700;color:#111827">Offer ends in</p>
  <img src="https://mailinapp.com/api/countdown?t=1753401600000&c=111827&s=9f2a..."
       width="207" height="34" alt="Offer ends in 2d 4h"
       style="display:block;max-width:100%;height:auto">
</div>

Ein Ende pro Kontakt (Eine Zeit nach dem Versand oder Ein Datum in den Kontaktdaten) wird beim Versand berechnet und in der Zeile des Empfängers als countdown_ends_<blockId> sowie in seinem Live-View-Token gespeichert, sodass jedes Öffnen dasselbe Ende zeigt. Ein Countdown, der beim Rendern schon abgelaufen ist, verschickt statt des Bildes seine Ablaufmeldung als Text. Klicks tragen das Ende des Empfängers, sodass der Rollup des Countdowns jeden Klick vor oder nach der eigenen Frist dieses Empfängers zählt.

Produkt

Mit dem MailInApp-Checkout ist Jetzt kaufen ein Bestätigungslink zu /v/[token]/act?action=buy. Die Bestätigungsseite liest das Produkt erneut aus der gespeicherten E-Mail, und ihr POST erstellt über /api/checkout die Stripe-Checkout-Session; ein bloßes GET erstellt nichts. Preis, Name und Bestand kommen immer aus der Kopie des Servers. Eine Bestellung gilt erst über Stripes signierten Webhook als bezahlt, der den Bestand in einer Transaktion erneut prüft und eine Zahlung erstattet, die den Bestand überschreiten würde. Mit gesetztem Lagerbestand trägt die Karte ein Bestandsabzeichen von /api/product-status, das höchstens einmal pro Minute aus der Zahl der bezahlten Stücke neu gezeichnet wird.

<div id="em-product-1" style="margin:12px 0;padding:16px;border:1px solid #e5e7eb;border-radius:8px;background-color:#ffffff">
  <p style="margin:0 0 4px;font-weight:600;font-size:16px;color:#111827">Limited edition tote bag</p>
  <p class="pd-price" style="margin:0 0 10px;font-weight:700;font-size:18px">$29.00</p>
  <img src="https://mailinapp.com/api/product-status?p=proj123&b=product-1&s=..."
       width="180" height="30" alt="" style="display:block;margin-bottom:8px">
  <a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=product-1&blockType=product&action=buy"
     style="display:inline-block;padding:10px 20px;background-color:#4f46e5;color:#ffffff;border-radius:6px;text-decoration:none;font-size:14px;font-weight:600">
    Buy now
  </a>
</div>

Mit Link zum Checkout eines externen Shops ist Jetzt kaufen ein Klick-Link zur Produktseite (mit ?variant= für eine importierte Shopify-Variante) oder zu einem empfängereigenen Rabattlink, der beim Versand erzeugt wird, wenn Rabatt für dieses Produkt aktiv ist.

Varianten verschicken vor dem Preis ein verstecktes Radio-Feld pro Optionswert, eine Reihe Chips (.pv-opts, <label for> auf die Radio-Felder) und ein Panel pro Variante (.pv-panels) mit Preis und Kauflink. Regeln der Form #<id>-a<i>:checked:not(:disabled) ~ … zeigen die Chips und das Panel der gewählten Variante und blenden .pd-price und .pv-list aus. Wo diese Regeln nicht greifen, erscheinen der Preis und .pv-list: ein Link pro Variante, der jeweils diese Variante kauft (&variant=<variantId>). Weitere Bilder nutzen die Miniaturen der Bildergalerie, mit kleinen verlinkten Bildern als Alternative. Für später merken ist ein Bestätigungslink mit action=save, einmal pro Empfänger erfasst.

<div class="pv-list">
  <a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=product-1&blockType=product&action=buy&variant=product-variant-2" ...>S / Navy · $56.00</a>
  <a href="...&variant=product-variant-3" ...>L / Navy · $60.00</a>
</div>
<p style="margin:10px 0 0;font-size:13px">
  <a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=product-1&blockType=product&action=save">♡ Save for later</a>
</p>

Produktraster

Das Raster ist eine Tabelle aus Karten, jede eine eigene umrandete Tabelle, mit Zellen, die sich auf dem Smartphone stapeln. Der Button jeder Karte ist ein Klick-Link unter der eigenen ID der Karte (blockType=product-card). Preise und Standardvarianten importierter Karten werden beim Rendern aus dem synchronisierten Katalog gelesen.

<td width="181" class="mia-stk" style="width:33%;vertical-align:top">
  <table role="presentation" width="100%" style="border:1px solid #e5e7eb;border-radius:8px;background-color:#ffffff">
    <tr><td style="padding:12px 12px 0;text-align:center">
      <img src="https://shop.example.com/tee.jpg" alt="Linen tee" width="155" style="display:block;width:100%;height:auto">
      <p style="margin:0 0 4px;font-weight:600;font-size:15px">Linen tee</p>
      <p style="margin:0 0 10px;font-weight:700;font-size:15px">$28.00</p>
    </td></tr>
    <tr><td style="padding:0 12px 12px;text-align:center">
      <a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=product-card-1&blockType=product-card&dest=https%3A%2F%2Fshop.example.com%2Fproducts%2Ftee&sig=..." ...>Shop now</a>
    </td></tr>
  </table>
</td>

Mit In den Warenkorb verlinkt der Button einer Warenkorb-Karte stattdessen die Warenkorbseite /v/[token]/cart/[blockId]?add=<cardId>. Diese Seite und das Raster der Live-Ansicht senden die gewählten item-IDs und qty_<cardId> an /api/cart, das Karten und Shop aus der gespeicherten E-Mail liest und zum Warenkorb-Permalink von Shopify oder zum Checkout-Link von WooCommerce weiterleitet. Der Gang zur Kasse wird als Klick auf das Raster erfasst, mit den gewählten Karten und Mengen im Wert.

Gutschein

Der Code ist schlichter Text in einem Feld mit user-select:all, sodass ein Tippen oder Doppelklick ihn ganz markiert. Der Shop-Button ist ein Klick-Link. In der Live-Ansicht, im Posteingang und in der App ist das Feld ein <button data-copy>, der den Code kopiert.

<div style="background-color:#fff7ed;text-align:center">
  <p style="margin:0 0 10px;font-size:15px;font-weight:700;color:#111827">Your exclusive discount</p>
  <p style="display:inline-block;margin:0;padding:12px 24px;border:2px dashed #4f46e5;border-radius:8px;background-color:#ffffff;font-size:26px;font-weight:800;letter-spacing:3px;color:#4f46e5;-webkit-user-select:all;user-select:all">SAVE20</p>
  <p style="margin:12px 0 0;font-size:13px;color:#6b7280">20% off until Sunday. Applied at checkout.</p>
</div>

Ein Code aus einem Merge-Tag wird pro Empfänger aufgelöst; ist er leer, wird der Block nicht gerendert.

Shop-Bewertungen

Shop-Bewertungen sind statischer Text: Die Sterne sind Textzeichen mit einem aria-label, und der Text jeder Bewertung trägt dir="auto". Die Bewertungen werden beim Rendern aus den synchronisierten storeReviews ausgewählt und nie im Baum der E-Mail gespeichert. Mit Einem Produkt ist der Link „Alle Bewertungen lesen“ ein Klick-Link zur Produktseite.

<p style="margin:0 0 14px;font-size:15px;color:#111827">
  <span role="img" aria-label="Rated 4.6 out of 5" style="color:#f59e0b">★★★★★</span> 4.6 from 212 reviews
</p>
<table role="presentation" width="100%">
  <tr><td style="padding:0 0 14px;border-bottom:1px solid #e5e7eb">
    <p style="margin:0 0 6px"><span role="img" aria-label="Rated 5.0 out of 5" style="color:#f59e0b">★★★★★</span></p>
    <p dir="auto" style="margin:0 0 4px;font-weight:700">Bright and floral</p>
    <p dir="auto" style="margin:0">Blueberry and jasmine notes, exactly as described.</p>
    <p dir="auto" style="margin:6px 0 0;font-size:12px;color:#6b7280">Amira H. · Verified buyer · Nov 2, 2026</p>
  </td></tr>
</table>

Die Live-Ansicht, der Posteingang und GET /api/v1/liveview/[token] lesen die Bewertungen bei jedem Öffnen neu.

Event-Blöcke

Zusage und Terminbuchung erfassen über Bestätigungslinks, wie die Feedback-Blöcke. Der Beitreten-Button eines Meeting-Links und der Anmelde-Button einer Webinar-Anmeldung sind Klick-Links über /v/[token]/click, wie die Links der Shop-Blöcke.

Die Statuszeile („Beginnt in …“, oder „Jetzt live“, sobald der Beginn vorbei ist) wird beim Rendern der E-Mail geschrieben. Darunter zeichnet ein <img> von /api/countdown, signiert wie das des Countdown-Blocks, bei jedem Öffnen der E-Mail die verbleibende Zeit. In der E-Mail ist der Beitreten-Button immer ein aktiver Klick-Link.

<div style="margin:12px 0;text-align:left;background-color:transparent">
  <p style="margin:0 0 6px;font-size:13px;font-weight:600;color:#111827">Starts in 2d 3h 30m</p>
  <img src="https://mailinapp.com/api/countdown?t=1768663800000&c=111827&s=..."
       width="357" height="81" alt="Starts in 2d 3h 30m" style="display:inline-block;max-width:100%;height:auto;margin-bottom:8px">
  <a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=meeting-link-1&blockType=meeting-link&dest=https%3A%2F%2Fmeet.google.com%2Fabc-defg-hij&sig=..."
     style="display:inline-block;padding:10px 20px;background-color:#4f46e5;color:#ffffff;border-radius:6px;text-decoration:none;font-size:14px;font-weight:600">
    Join on Google Meet
  </a>
  <p style="margin:8px 0 0;font-size:13px;color:#4b5563">Dial in: +1 555-0100, PIN 1234</p>
</div>

Live-Ansicht, Posteingang und mobile App zeigen den Beitreten-Button erst ab Beitrittslink öffnet vor dem Beginn Minuten vor startsAt, berechnet aus den Props des Blocks beim Rendern, ohne gespeicherten Zustand. Bis dahin zeigen sie einen inaktiven Chip „Öffnet N Minuten vor Beginn“. Ein Block ohne startsAt ist immer offen.

Zusage

Jede Antwort ist ein Bestätigungslink mit response=yes, no oder maybe. Mit Begleitpersonen erlauben führt Ja zur Live-Ansicht, wo der Empfänger die Zahl der Begleitpersonen wählt. Zeigen, wie viele kommen fügt ein <img> von /api/rsvp-count hinzu, signiert pro Block, Farbe und Breite, nie pro Empfänger, und beim Öffnen aus dem Rollup der Zusage gezeichnet.

<div id="em-rsvp-1" style="margin:12px 0;background-color:transparent">
  <p style="margin:0 0 10px;font-weight:600;font-size:16px;color:#111827">Coming to the launch?</p>
  <p style="margin:0 0 10px;font-size:12px;color:#6b7280">Limited to 80 spots</p>
  <img src="https://mailinapp.com/api/rsvp-count?p=proj123&b=rsvp-1&c=4f46e5&w=320&s=..."
       alt="How many people are going" width="320" height="28" style="display:block;width:100%;max-width:320px;height:auto;border:0">
  <div>
    <a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=rsvp-1&blockType=rsvp&action=rsvp&response=yes" ...>Yes</a>
    <a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=rsvp-1&blockType=rsvp&action=rsvp&response=maybe" ...>Maybe</a>
    <a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=rsvp-1&blockType=rsvp&action=rsvp&response=no" ...>No</a>
  </div>
</div>

Kapazitätsprüfung und Deduplizierung pro Empfänger laufen in einer einzigen Firestore-Transaktion, sodass Plätze nie überbucht werden: Eine Zusage über der Kapazität wird als waitlisted erfasst, eine Absage als declined, ein Vielleicht als maybe ohne Platz. Die Fragen nach einer Zusage werden als submit auf die Block-ID mit dem Zusatz __details gesendet, die der Server nur von einem Empfänger annimmt, dessen erfasste Antwort ein Ja ist, und wie die Antworten eines Formulars prüft.

Terminbuchung

Die Zeiten sind die nächsten freien Slots des Termintyps, beim Rendern der E-Mail berechnet und in der Zeitzone des Termintyps beschriftet. In der E-Mail ist jede Zeit ein Bestätigungslink mit action=book&slot=<epoch ms>, und Weitere Zeiten ansehen öffnet die Live-Buchungsseite /v/[token]/book/[blockId].

<div id="em-booking-1" style="margin:12px 0;background-color:transparent">
  <p style="margin:0 0 10px;font-weight:600;font-size:16px;color:#111827">Book a time with us</p>
  <p style="margin:0 0 8px;font-size:13px;color:#6b7280">Times in Eastern Time</p>
  <div class="bk-panels">
    <div id="em-booking-1-g0" class="bk-p">
      <p class="bk-dh" style="margin:6px 0 4px;font-size:12px;font-weight:600;color:#374151">Monday, January 19</p>
      <a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=booking-1&blockType=booking&action=book&slot=1768831200000" ...>9:00 AM</a>
      <a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=booking-1&blockType=booking&action=book&slot=1768834800000" ...>10:00 AM</a>
    </div>
  </div>
  <p style="margin:8px 0 0;font-size:13px">
    <a href="https://mailinapp.com/v/eyJhbGci.../book/booking-1" style="color:inherit;text-decoration:underline">See more times</a>
  </p>
</div>

Mit Tage als Tabs zeigen steht vor einer Tab-Leiste (.bk-bar) ein verstecktes Radio pro Tag (#<id>-d<i>), und Regeln der Form #<id>-d<i>:checked:not(:disabled) ~ … zeigen das Panel eines Tages (.bk-p). Wo diese Regeln nicht greifen, erscheint jedes Panel unter seiner Tagesüberschrift (.bk-dh). In Live-Ansicht, Posteingang und App sind die Zeiten Radio-Chips in einem Formular, das action=book mit dem gewählten slot an /api/interactions sendet.

Vor der Buchung liest der Server die Verfügbarkeit des Kalenders erneut und belegt den Slot in einer Transaktion, sodass ein Slot nur einmal gebucht wird. Ein Empfänger wird als sein eigener Kontakt gebucht, einmal pro Block. Ein Token ohne Kontakt dahinter wird zur Buchungsseite geleitet, die hinter einer Bot-Prüfung Name und E-Mail-Adresse abfragt.

Webinar-Anmeldung

Die Karte ist überall gleich. Das Datum wird in der Zeitzone des Blocks mit genannter Zone formatiert, und Jetzt anmelden ist ein Klick-Link zur öffentlichen Seite der Session /webinar/<liveSessionId>, gebildet aus der Session-ID ohne Abfrage beim Versand.

<div style="margin:12px 0;background-color:transparent">
  <img src="https://example.com/webinar-cover.jpg" alt="Office hours"
       style="width:100%;max-width:100%;border-radius:6px;display:block;margin-bottom:10px">
  <p style="margin:0 0 4px;font-weight:600;font-size:16px;color:#111827">Office hours</p>
  <p style="margin:0 0 8px;font-size:13px;color:#6b7280">Mar 1, 2026, 12:00 PM EST</p>
  <a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=webinar-signup-1&blockType=webinar-signup&dest=https%3A%2F%2Fmailinapp.com%2Fwebinar%2Fsess_abc123&sig=..."
     style="display:inline-block;padding:10px 20px;background-color:#4f46e5;color:#ffffff;border-radius:6px;text-decoration:none;font-size:14px;font-weight:600">
    Register now
  </a>
</div>

Die Anmeldungen erfasst die Seite der Session, der Block selbst erfasst nur den Klick.

Präsentationsblöcke

Diese Blöcke erfassen keine Antwort. Jeder verschickt seinen Inhalt in einer Form, die für sich gut lesbar ist, und fügt dann :checked-Regeln hinzu, die daraus die interaktive Version machen, wo die E-Mail-App sie ausführt. Die Regeln stehen im <style> im <head>, und die Eingabefelder, an denen sie hängen, sind in <!--[if !mso]><!--> eingeschlossen, sodass das klassische Outlook sie nie sieht.

Zwei Muster decken alle sieben ab:

  • Radio-Gruppen (Karussell, Tabs, Bildergalerie): ein verstecktes Radio pro Folie, Tab oder Bild vor dem Inhalt, mit Labels for diese Radios als Punkte, Tab-Leiste oder Miniaturen. Jede Regel lautet #<radio>:checked:not(:disabled) ~ …. Eine App, die die Eingabefelder entfernt, trifft keine davon, und der Fallback bleibt stehen.
  • Checkbox-Schalter (Akkordeon, Vorher / Nachher, Bild-Hotspots, Menü): eine immer angehakte Tor-Checkbox #<id>-k vor dem Block und der Schalter #<id>-t im angetippten <label>. Die Regeln, die etwas ausblenden, beginnen bei #<id>-k:checked, sodass eine App, die das Tor entfernt, alles zeigt.

Links in diesen Blöcken laufen wie jeder andere Link über /v/[token]/click.

Karussell

Jede Folie wird zweimal gezeichnet: einmal in .carousel-fallback (die erste Folie und der Link Alle N Folien ansehen, oder alle Folien in einer Tabelle .carousel-grid) und einmal als verstecktes .lv-frame, das die Regeln eines Radios zeigen. Der Streifen .lv-px lädt aus der Regel jeder Folie nach der ersten einen Folienansichts-Beacon, /v/[token]/nv/<blockId>/<slide>. So zählt Insights die Empfänger, die über die erste Folie hinaus gewechselt haben.

<div id="em-carousel-g1">
  <input type="radio" name="em-carousel-g1" id="em-carousel-g1-s0" checked hidden style="display:none">
  <input type="radio" name="em-carousel-g1" id="em-carousel-g1-s1" hidden style="display:none">
  <div class="carousel-fallback">
    <div class="lv-frame lv-frame-0">
      <img src="https://cdn.example.com/slide1.jpg" alt="Slide 1" style="width:100%">
      <p style="margin:8px 0 0;font-size:14px;color:#374151">Slide 1</p>
    </div>
    <p style="margin:8px 0 0;font-size:13px">
      <a href="https://mailinapp.com/v/eyJhbGci..." style="color:#4f46e5">See all 2 slides &rarr;</a>
    </p>
  </div>
  <div class="lv-frames">
    <div class="lv-frame lv-frame-0" style="display:none">…</div>
    <div class="lv-frame lv-frame-1" style="display:none">…</div>
  </div>
  <div class="lv-dots" style="display:none;text-align:center">
    <label for="em-carousel-g1-s0" class="lv-dot lv-dot-0" aria-label="Slide 1"></label>
    <label for="em-carousel-g1-s1" class="lv-dot lv-dot-1" aria-label="Slide 2"></label>
  </div>
  <div class="lv-px" style="height:4px">&nbsp;</div>
</div>
#em-carousel-g1-s1:checked:not(:disabled) ~ .carousel-fallback{display:none!important}
#em-carousel-g1-s1:checked:not(:disabled) ~ .lv-dots{display:block!important}
#em-carousel-g1-s1:checked:not(:disabled) ~ .lv-frames .lv-frame-1{display:block!important}
#em-carousel-g1-s1:checked:not(:disabled) ~ .lv-px{background-image:url(https://mailinapp.com/v/eyJhbGci.../nv/carousel-g1/1)}

Pfeile sind Labels for die benachbarten Radios in jedem Frame. Miniaturen ersetzen die Punkte durch Labels .lv-tn. Automatisches Abspielen fügt ein weiteres, zuerst angehaktes Radio hinzu, dessen Regeln die Frames mit einer @keyframes-Animation innerhalb von @media (prefers-reduced-motion:no-preference) entlang einer .lv-track bewegen; die Wahl einer Folie hebt es auf. Preis und Button einer Folie gehören zur Folie, erscheinen also auch im Fallback, und der Button verlinkt auf das eigene href der Folie.

Akkordeon

Der Inhalt jedes Eintrags steht im <label> des Eintrags, nach dem Schalter, und erscheint daher überall dort, wo die Regeln nicht laufen. In der Live-Ansicht, im Posteingang und auf der Arbeitsfläche ist jeder Eintrag stattdessen ein natives <details>/<summary>.

<div id="em-accordion-item-g2" style="border:1px solid #e5e7eb;border-radius:6px;padding:10px 14px">
  <input type="checkbox" id="em-accordion-item-g2-k" checked hidden style="display:none">
  <label style="display:block;cursor:pointer">
    <input type="checkbox" id="em-accordion-item-g2-t" hidden style="display:none">
    <span style="display:block;font-weight:600;font-size:15px">Do you offer refunds?</span>
    <div class="acc-content" style="margin:8px 0 0;font-size:14px">Yes, within 30 days of purchase.</div>
  </label>
</div>
#em-accordion-item-g2-k:checked ~ label .acc-content{display:none}
#em-accordion-item-g2-t:checked ~ div.acc-content{display:block}

Tabs

Die Blöcke jedes Tabs werden einmal geschrieben, in einem Panel .tb-p, das mit dem Titel des Tabs als Überschrift .tb-h beginnt. Diese untereinander stehenden Panels sind der Fallback. Die Regeln der Radios zeigen die .tb-bar, blenden die Überschriften aus und zeigen ein Panel.

<div id="em-tabs-g1">
  <input type="radio" name="em-tabs-g1" id="em-tabs-g1-r0" checked hidden style="display:none">
  <input type="radio" name="em-tabs-g1" id="em-tabs-g1-r1" hidden style="display:none">
  <div class="tb-bar" role="tablist" style="display:none">
    <label for="em-tabs-g1-r0" id="em-tabs-g1-t0" class="tb-t" role="tab">Overview</label>
    <label for="em-tabs-g1-r1" id="em-tabs-g1-t1" class="tb-t" role="tab">Details</label>
  </div>
  <div class="tb-panels">
    <div id="em-tabs-g1-p0" class="tb-p"><p class="tb-h" style="font-weight:700">Overview</p>…</div>
    <div id="em-tabs-g1-p1" class="tb-p"><p class="tb-h" style="font-weight:700">Details</p>…</div>
  </div>
</div>
#em-tabs-g1-r1:checked:not(:disabled) ~ .tb-bar{display:block!important}
#em-tabs-g1-r1:checked:not(:disabled) ~ .tb-panels .tb-h{display:none!important}
#em-tabs-g1-r1:checked:not(:disabled) ~ .tb-panels .tb-p{display:none}
#em-tabs-g1-r1:checked:not(:disabled) ~ .tb-panels #em-tabs-g1-p1{display:block!important}

Vorher / Nachher

Beide Bilder stehen in einem <label>, jedes unter seiner Beschriftung. Die Regeln des Tors blenden das Nachher-Bild aus und zeigen den Hinweis; der Schalter tauscht die beiden.

<div id="em-before-after-g1">
  <input type="checkbox" id="em-before-after-g1-k" checked hidden style="display:none">
  <label style="display:block;cursor:pointer">
    <input type="checkbox" id="em-before-after-g1-t" hidden aria-label="Switch between the before and after pictures" style="display:none">
    <div class="ba-before">
      <p class="ba-cap">Before</p>
      <img src="https://example.com/kitchen-before.jpg" alt="Before: The kitchen" width="568">
      <p class="ba-hint" style="display:none">Tap to see after</p>
    </div>
    <div class="ba-after" style="margin-top:12px">
      <p class="ba-cap">After</p>
      <img src="https://example.com/kitchen-after.jpg" alt="After: The kitchen" width="568">
      <p class="ba-hint" style="display:none">Tap to see before</p>
    </div>
  </label>
</div>
#em-before-after-g1-k:checked ~ label .ba-after{display:none}
#em-before-after-g1-k:checked ~ label .ba-hint{display:block!important}
#em-before-after-g1-t:checked ~ div.ba-before{display:none}
#em-before-after-g1-t:checked ~ div.ba-after{display:block;margin-top:0!important}

Bild-Hotspots

Markierungen werden nur durch Regeln hinter dem Tor platziert, nie durch ein Inline-position (das Gmail entfernt). Jede Markierung ist ein <label> um ihre eigene Checkbox und Notiz. Die nummerierte .hs-legend unter dem Bild ist der Fallback, und die Regeln des Tors blenden sie aus.

<div id="em-image-hotspots-g4">
  <input type="checkbox" id="em-image-hotspots-g4-k" checked hidden style="display:none">
  <div class="hs-stage">
    <img src="https://example.com/bike.jpg" alt="Our commuter bike" width="568">
    <label id="em-image-hotspots-g4-h0" class="hs-pin" style="display:none">
      <input type="checkbox" id="em-image-hotspots-g4-h0-t" hidden aria-label="Hydraulic brakes" style="display:none">
      <span class="hs-num">1</span>
      <span class="hs-note" style="display:none"><strong>Hydraulic brakes</strong>Stop short in the wet.</span>
    </label>
  </div>
  <div class="hs-legend">
    <p><strong>1. Hydraulic brakes</strong> — Stop short in the wet.</p>
  </div>
</div>
#em-image-hotspots-g4-k:checked ~ div.hs-stage{position:relative}
#em-image-hotspots-g4-k:checked ~ div.hs-legend{display:none}
#em-image-hotspots-g4-k:checked ~ div.hs-stage #em-image-hotspots-g4-h0{display:block!important;position:absolute;left:20%;top:30%;margin:-13px 0 0 -13px}
#em-image-hotspots-g4-h0-t:checked ~ .hs-note{display:block!important;position:absolute;left:-8px;top:32px}

Eine Notiz öffnet sich nach links oder rechts und nach oben oder unten, je nachdem, wo ihre Markierung sitzt: jenseits von 60 % horizontal oder 65 % vertikal.

Bildergalerie

Das erste Bild steht immer in .gl-main; die anderen sind dort versteckte Frames. .gl-fallback zeigt sie klein, jedes mit einem Link zur Live-Ansicht, und die Regeln der Radios tauschen es gegen die Reihe .gl-thumbs aus Labels. Der Produkt-Block zeichnet seine weiteren Bilder mit denselben Teilen.

<div id="em-image-gallery-g4">
  <input type="radio" name="em-image-gallery-g4" id="em-image-gallery-g4-r0" checked hidden style="display:none">
  <input type="radio" name="em-image-gallery-g4" id="em-image-gallery-g4-r1" hidden style="display:none">
  <div class="gl-main">
    <div id="em-image-gallery-g4-f0" class="gl-f"><img src="https://example.com/chair-front.jpg" alt="Chair from the front" width="568"></div>
    <div id="em-image-gallery-g4-f1" class="gl-f" style="display:none"><img src="https://example.com/chair-side.jpg" alt="Chair from the side" width="568"></div>
  </div>
  <div class="gl-fallback">
    <a href="https://mailinapp.com/v/eyJhbGci..."><img src="https://example.com/chair-side.jpg" alt="Chair from the side" width="64" height="64"></a>
  </div>
  <div class="gl-thumbs" style="display:none">
    <label for="em-image-gallery-g4-r0" id="em-image-gallery-g4-t0" class="gl-t" aria-label="Picture 1">…</label>
    <label for="em-image-gallery-g4-r1" id="em-image-gallery-g4-t1" class="gl-t" aria-label="Picture 2">…</label>
  </div>
</div>
#em-image-gallery-g4-r1:checked:not(:disabled) ~ .gl-fallback{display:none!important}
#em-image-gallery-g4-r1:checked:not(:disabled) ~ .gl-thumbs{display:block!important}
#em-image-gallery-g4-r1:checked:not(:disabled) ~ .gl-main .gl-f{display:none!important}
#em-image-gallery-g4-r1:checked:not(:disabled) ~ .gl-main #em-image-gallery-g4-f1{display:block!important}

Die Links bilden eine .mn-row, jeder ein Klick-Link mit eigenem Platz (blockType=menu-item), sodass Insights jeden Link benennt. Die .mn-bar und die Regeln, die die Reihe einklappen, stehen bei Auf Smartphones in @media only screen and (max-width:620px), bei Immer auf oberster Ebene.

<div id="em-menu-g5">
  <input type="checkbox" id="em-menu-g5-k" checked hidden style="display:none">
  <label style="display:block;cursor:pointer">
    <input type="checkbox" id="em-menu-g5-t" hidden aria-label="Show or hide the links" style="display:none">
    <div class="mn-bar" style="display:none"><span class="mn-open">&#9776;</span><span class="mn-close" style="display:none">&#10005;</span> Menu</div>
    <div class="mn-row" style="text-align:center">
      <span class="mn-i"><a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=menu-item-g1&amp;blockType=menu-item&amp;dest=https%3A%2F%2Fshop.example.com%2F&amp;sig=...">Shop</a></span>
      <span class="mn-sep" aria-hidden="true">|</span>
      <span class="mn-i"><a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=menu-item-g2&amp;blockType=menu-item&amp;dest=https%3A%2F%2Fshop.example.com%2Fnew&amp;sig=...">New in</a></span>
    </div>
  </label>
</div>
@media only screen and (max-width:620px){
  #em-menu-g5-k:checked ~ label .mn-bar{display:block!important}
  #em-menu-g5-k:checked ~ label .mn-row{display:none}
  #em-menu-g5-t:checked ~ div.mn-row{display:block}
  #em-menu-g5-t:checked ~ div.mn-row .mn-i{display:block!important}
  #em-menu-g5-t:checked ~ div.mn-row .mn-sep{display:none}
}

Spielblöcke

Die drei Spiele teilen ein Muster. Eine immer angehakte Tor-Checkbox #<id>-k steht vor einem <label>, das ein Radio, die Abdeckung (.sc-surface oder das Rad .stw-wheel mit seinem Button .stw-go) und den Gewinn (.sc-prize, .stw-prize) enthält. Die Regeln des Tors zeigen die Abdeckung und blenden den Gewinn aus. Ein Tippen auf das Label hakt das Radio an, dessen Regeln die Abdeckung ausblenden und den Gewinn zeigen.

Ein Radio, keine Checkbox, damit ein zweites Tippen den Gewinn nicht wieder verbirgt. Die Eingabefelder stehen in <!--[if !mso]><!-->, und eine App, die das Tor entfernt, zeigt, was außerhalb der Regeln steht.

Jeder Block erfasst ein reveal. In der E-Mail lädt die Regel des Radios ein Aufdeck-Beacon, /v/[token]/rv/<blockId>, als Hintergrund eines 4px-Streifens (.sc-px, .stw-px), und die Live-Ansicht sendet die Aufdeckung aus ihrem Inline-Skript. Gewinn-Links laufen über /v/[token]/click.

Gewinne. Mit game-prize-Kindern wählt der Server den Gewinn jedes Empfängers, bevor die E-Mail gerendert wird: eine gewichtete Auswahl, deren Startwert ein HMAC aus Projekt, Block und Empfänger ist, einmal in gamePrizes/{projectId}_{blockId}_{recipient} mit seinem Code erfasst. Das Ergebnis reist in der Zeile des Empfängers als prize_<blockId>, prize_label_<blockId>, prize_code_<blockId> und prize_url_<blockId>, sodass E-Mail, Live-Ansicht, Posteingang und App denselben Gewinn zeigen.

Das Gewinnfeld steht dann nur im interaktiven Teil, und ein Link Meinen Gewinn aufdecken zur Live-Ansicht (.stw-reveal, .sc-reveal) steht außerhalb davon, verborgen durch die Regel des Tors. Eine E-Mail, die ohne Ergebnis in der Zeile gerendert wird (ein Export, eine fehlgeschlagene Zuteilung), zeigt nur diesen Link, und die Live-Ansicht teilt den Gewinn zu. Das Aufdeck-Ereignis trägt den erfassten Gewinn, nie einen gesendeten.

Glücksrad

Das Rad ist ein 240px-conic-gradient mit einem gleich großen Feld pro Gewinn, weiß beschriftet mit Schatten, damit der Dark Mode es lesbar lässt. Seine @keyframes drehen es in 3,2 Sekunden auf den Winkel des Gewinns des Empfängers, danach blendet das Gewinnfeld ein. Das klassische Outlook bekommt den Aufdeck-Link als VML-Button.

<div id="em-spin-to-win-g5" style="text-align:center">
  <p style="font-weight:700;font-size:18px">Spin for a summer treat</p>
  <!--[if !mso]><!-->
  <input type="checkbox" id="em-spin-to-win-g5-k" checked hidden style="display:none">
  <label style="display:block;cursor:pointer">
    <input type="radio" id="em-spin-to-win-g5-spin" hidden aria-label="Spin the wheel to reveal your prize" style="display:none">
    <span class="stw-ptr" aria-hidden="true" style="display:none">▼</span>
    <span class="stw-wheel" aria-hidden="true" style="display:none;width:240px;height:240px;border-radius:50%;
          background:conic-gradient(#4f46e5 0deg 90deg,#847eed 90deg 180deg,#3b35ac 180deg 270deg,#f59e0b 270deg 360deg)">
      <span style="position:absolute;transform:rotate(45deg)">10% off</span>
      …
    </span>
    <span class="stw-go" style="display:none">Spin the wheel</span>
    <div class="stw-prize" role="status" style="display:none">
      <p style="font-weight:700">You won: 10% off!</p>
      <p>Your next order is 10% off.</p>
      <p aria-label="Your code" style="border:2px dashed currentColor;font-family:monospace">SPIN10-AB12</p>
    </div>
    <div class="stw-px" style="height:4px">&nbsp;</div>
  </label>
  <!--<![endif]-->
  <div class="stw-reveal">
    <a href="https://mailinapp.com/v/eyJhbGci...">Reveal my prize</a>
  </div>
</div>
#em-spin-to-win-g5-k:checked ~ label .stw-wheel{display:block!important}
#em-spin-to-win-g5-k:checked ~ label .stw-go{display:inline-block!important}
#em-spin-to-win-g5-k:checked ~ .stw-reveal{display:none!important}
#em-spin-to-win-g5-spin:checked ~ span.stw-wheel{animation:stw-em-spin-to-win-g5 3200ms cubic-bezier(.17,.67,.21,1) both}
#em-spin-to-win-g5-spin:checked ~ div.stw-prize{display:block!important;animation:stw-in-em-spin-to-win-g5 .4s ease-out 3200ms both}
#em-spin-to-win-g5-spin:checked ~ .stw-px{background-image:url(https://mailinapp.com/v/eyJhbGci.../rv/spin-to-win-g5)}
@keyframes stw-em-spin-to-win-g5{from{transform:rotate(0deg)}to{transform:rotate(2115deg)}}

Ohne Gewinne ist das Rad ein 64px-🎡, das sich in 0,9 Sekunden zweimal dreht und einen getrackten Button zum Gewinn-Link enthüllt. Ein zweiter Button zum selben Link, Gewinn anzeigen, steht für jede andere App außerhalb des interaktiven Teils (ein Link zur Live-Ansicht, wenn der Gewinn-Link leer ist). Die Live-Ansicht zeigt den Titel und den Gewinn-Button.

Rubbellos

Ohne Gewinne bleibt der Gewinn außerhalb des interaktiven Teils, sodass eine App, die die Regeln entfernt, ihn sofort zeigt. Die Abdeckung ist ein <span> mit display:none, das nur die Regel des Tors zeigt: silberne Streifen, die Farbe der Rubbelschicht oder ein <img> für das Startbild (nie ein CSS-url()). Die Schaltfläche zum Aufdecken fügt ein .sc-go-Span im Label hinzu.

<div id="em-scratch-card-g1" style="text-align:center">
  <p style="font-weight:700;font-size:18px">Scratch to reveal your prize!</p>
  <!--[if !mso]><!-->
  <input type="checkbox" id="em-scratch-card-g1-k" checked hidden style="display:none">
  <!--<![endif]-->
  <label style="display:block;cursor:pointer">
    <!--[if !mso]><!-->
    <input type="radio" id="em-scratch-card-g1-scratch" hidden aria-label="Scratch to reveal the hidden reward" style="display:none">
    <span class="sc-surface" style="display:none;padding:24px;border-radius:8px;
          background:repeating-linear-gradient(45deg,#9ca3af,#9ca3af 10px,#d1d5db 10px,#d1d5db 20px)">Scratch here</span>
    <div class="sc-px" style="height:4px">&nbsp;</div>
    <!--<![endif]-->
    <div class="sc-prize" style="margin-top:10px">
      <a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=scratch-card-g1&blockType=scratch-card&dest=…&sig=…">🎉 20% off your next order!</a>
    </div>
  </label>
</div>
#em-scratch-card-g1-k:checked ~ label #em-scratch-card-g1-scratch{display:block!important;position:absolute;width:1px;height:1px;opacity:0}
#em-scratch-card-g1-k:checked ~ label .sc-surface{display:block!important}
#em-scratch-card-g1-k:checked ~ label .sc-prize{display:none!important}
#em-scratch-card-g1-scratch:checked ~ span.sc-surface{display:none!important}
#em-scratch-card-g1-scratch:checked ~ div.sc-prize{display:block!important}
#em-scratch-card-g1-scratch:focus ~ .sc-surface{outline:3px solid #4f46e5;outline-offset:2px}
#em-scratch-card-g1-scratch:checked ~ .sc-px{background-image:url(https://mailinapp.com/v/eyJhbGci.../rv/scratch-card-g1)}

Die Regel des Tors macht das Radio zu einem fokussierbaren 1px-Element, so erreicht Tab das Los und die Leertaste enthüllt es. Mit Button unter der Karte steht der getrackte Button nach dem </label>, außerhalb jeder Regel, und ist so vor und nach dem Rubbeln zu sehen.

Überraschungsbox

Markup und Regeln des Rubbelloses, mit einer Geschenkbox als Abdeckung: ein 72px-🎁 (oder das Bild der Box) und der Tipptext. Eine weitere Regel lässt die Box wackeln, solange sie geschlossen ist.

<label style="display:block;cursor:pointer">
  <input type="radio" id="em-mystery-box-g1-scratch" hidden aria-label="Open the mystery box to reveal your prize" style="display:none">
  <span class="sc-surface" style="display:none;padding:8px 0">
    <span class="sc-box" aria-hidden="true" style="display:inline-block;font-size:72px">🎁</span>
    <span style="display:block;font-weight:700">Tap the box to open it</span>
  </span>
  …
</label>
#em-mystery-box-g1-k:checked ~ label .sc-box{animation:mb-em-mystery-box-g1 2.4s ease-in-out infinite}
@keyframes mb-em-mystery-box-g1{0%,70%,100%{transform:rotate(0deg)}76%{transform:rotate(-8deg)}82%{transform:rotate(7deg)}88%{transform:rotate(-4deg)}94%{transform:rotate(2deg)}}

Lernblöcke

Der Lernkarten-Stapel erfasst nichts. Die Aufgabe erfasst eine Abgabe pro Empfänger.

Lernkarten-Stapel

Jede Karte hat die Form von Vorher / Nachher: eine immer angehakte Tor-Checkbox #<card>-k, dann ein <label> mit der eigenen Checkbox der Karte #<card>-f, der Vorderseite .fc-front und der Rückseite .fc-back. Die Regeln des Tors blenden die Rückseite und die Seitenbeschriftungen .fc-l aus. Das Anhaken der Checkbox der Karte blendet die Vorderseite aus und zeigt die Rückseite.

Jede Regel nennt :checked, sodass eine App, die sie verwirft, Vorder- und Rückseite untereinander zeigt, die Rückseite unter einer gestrichelten Linie, jede Seite mit ihrer Beschriftung vorneweg („F: “ und „A: “, in der Sprache der E-Mail). Eine Karte, die schon mit ihrer Beschriftung beginnt, behält sie nur einmal. Eine Karte mit einem Bild nur auf der Vorderseite behält umgedreht eine Höhe von 200px, damit sich der Stapel unter dem Finger des Empfängers nicht verschiebt. Die Live-Ansicht zeichnet dasselbe Markup, und der Nur-Text-Teil schreibt jede Karte als zwei Zeilen.

<div id="em-flashcard-g2" style="border:1px solid #e5e7eb;border-radius:8px;padding:14px;margin-bottom:8px;text-align:center">
  <!--[if !mso]><!-->
  <input type="checkbox" id="em-flashcard-g2-k" checked hidden style="display:none">
  <!--<![endif]-->
  <label style="display:block;cursor:pointer">
    <!--[if !mso]><!-->
    <input type="checkbox" id="em-flashcard-g2-f" hidden style="display:none">
    <!--<![endif]-->
    <div class="fc-front">
      <p style="margin:0;font-weight:600;font-size:16px"><span class="fc-l">Q: </span>What is the powerhouse of the cell?</p>
    </div>
    <div class="fc-back" style="margin-top:10px;padding-top:10px;border-top:1px dashed #e5e7eb">
      <p style="margin:0;font-size:16px"><span class="fc-l">A: </span>The mitochondria</p>
    </div>
  </label>
</div>
#em-flashcard-g2-k:checked ~ label .fc-back{display:none}
#em-flashcard-g2-k:checked ~ label .fc-l{display:none}
#em-flashcard-g2-f:checked ~ div.fc-front{display:none}
#em-flashcard-g2-f:checked ~ div.fc-back{display:block;margin-top:0!important;padding-top:0!important;border-top:0!important}

Aufgabe

Der Abgabetermin ist das Bild des Countdown-Blocks, /api/countdown, signiert für die Frist, unter einer Zeile „Fällig“. Die Mail schreibt keine verbleibende Zeit, da sie nach dem Rendern gelesen wird, und der Alt-Text des Bildes lautet „Verbleibende Zeit bis zur Abgabe“. Eine E-Mail, die nach der Frist gerendert wird, sagt stattdessen „Überfällig“. Die Live-Ansicht schreibt die verbleibende Zeit aus („Fällig in 2 T. 4 Std. 10 Min.“). Die Links zu Materialien sind einfache Links, und Punkte fügt dem Titel „(10 Pkt.)“ hinzu.

Als erledigt markieren ist eine Auswahl wie bei einer Umfrage: in der Mail ein Link zu /v/[token]/act?action=complete, wo der Empfänger bestätigt. Eine kurze Text- oder Link-Antwort ist ein <form>, das action: "submit-answer" mit answer (ein dreizeiliges <textarea> oder ein <input type="url">) an /api/interactions sendet, innerhalb von <!--[if !mso]>, mit einem Link Im Web antworten zur Live-Ansicht (#em-<id>) darunter in jeder App.

Eine Abgabe wird pro Empfänger dedupliziert wie eine Stimme, und die Live-Ansicht liest sie zurück: „Als erledigt markiert ✓“ oder „Abgegeben ✓“ mit der Antwort. Eine Abgabe nach dueAt wird wie jede andere erfasst, und Insights liest pünktlich oder verspätet aus ihrem Zeitpunkt (homeworkBlocks).

<div id="em-assignment-g2">
  <p style="margin:0 0 4px;font-weight:700;font-size:18px">Read chapter 4 (10 pts)</p>
  <p style="margin:0 0 10px;font-size:14px;color:#4b5563">Summarize the main themes in 2-3 sentences.</p>
  <p style="margin:0 0 6px;font-size:13px;font-weight:600">Due</p>
  <img src="https://mailinapp.com/api/countdown?t=1768663800000&c=111827&s=…" width="357" height="81"
       alt="Time left before it's due" style="display:block;max-width:100%;height:auto;margin-bottom:8px">
  <div style="margin:0 0 10px">
    <p style="margin:0 0 4px;font-size:13px"><a href="https://example.com/ch4.pdf">Chapter 4 PDF</a></p>
  </div>
  <div>
    <!--[if !mso]><!-->
    <form method="post" action="https://mailinapp.com/api/interactions?campaignId=…&blockId=assignment-g2&redirect=…">
      <!-- hidden campaignId, blockId, blockType, action=submit-answer, rcpt, redirect -->
      <textarea name="answer" rows="3" placeholder="Your answer" required></textarea>
      <button type="submit">Submit answer</button>
    </form>
    <!--<![endif]-->
    <p style="margin:8px 0 0;font-size:13px;text-align:center">
      <a href="https://mailinapp.com/v/eyJhbGci...#em-assignment-g2">Answer on the web</a>
    </p>
  </div>
</div>

Inhaltsblöcke

Diese Blöcke zeichnen keine Antworten auf. Video, Audio, Veranstaltungsort und „Zum Kalender hinzufügen“ sind Klick-Slots: In einem personalisierten Versand läuft jeder Link über /v/[token]/click?blockId=…&blockType=…&dest=…&sig=…, das einen click auf dem Block aufzeichnet und zu dest weiterleitet. Eine exportierte E-Mail ohne Empfänger-Token verlinkt direkt auf das Ziel. Das gemailte Markup ist in jeder E-Mail-App gleich; nur die Live-Ansicht weicht ab, bei Video und Audio.

Video und Audio

Die E-Mail zeichnet ein Bild im Klick-Link: das Vorschau- oder Titelbild als einfaches <img>, dessen alt die Beschreibung ist, oder ohne Bild eine dunkle Fläche mit ▶ oder ♪, der Beschreibung und beim Video der Dauer als M:SS. Breite, Innenabstand, Rahmen und Hintergrund des Blocks liegen auf dem äußeren <div>, sodass die Fläche ihren eigenen Innenabstand behält.

Die Live-Ansicht und der Posteingang von MailInApp zeichnen ein <video controls> mit dem Vorschaubild als poster oder ein <audio controls> unter dem Titelbild-<img>, jeweils mit der Beschreibung als aria-label. Die mobile App öffnet die Datei. Ein Block ohne src erzeugt nichts.

<a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=video-g1&amp;blockType=video&amp;dest=https%3A%2F%2Fexample.com%2Fpromo.mp4&amp;sig=…">
  <div style="box-sizing:border-box;overflow:hidden;width:100%;max-width:100%">
    <img src="https://example.com/promo-poster.jpg" alt="Product demo" style="display:block;width:100%;max-width:100%" />
  </div>
</a>
<a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=audio-g2&amp;blockType=audio&amp;dest=https%3A%2F%2Fexample.com%2Fno-cover.mp3&amp;sig=…">
  <div style="box-sizing:border-box;overflow:hidden;width:100%;max-width:100%">
    <div style="background-color:#111827;color:#ffffff;text-align:center;padding:40px 16px;font-size:18px;font-weight:600">♪ Audio</div>
  </div>
</a>

Formel

Die Formel ist ein PNG von GET /api/formula. Notation (auf 300 Zeichen gekürzt), Darstellung und Farbe sind in die signierte Query serialisiert, sodass der Endpunkt nichts aus Firestore liest und mit einem unveränderlichen Cache-Header antwortet; der Edge-Worker liefert ihn aus. Der Emitter setzt die Formel einmal, um width und height des <img> zu schreiben, damit die E-Mail beim Laden nicht umbricht, und das Layout verkleinert den Maßstab, um im Größenbudget des Bildes zu bleiben. Das alt ist die Notation selbst, ebenso der Klartext-Teil.

Der Parser ist MailInApps eigener (keine TeX-Engine): Ein unbekanntes Makro wird als wörtlicher Text gezeichnet, und der Renderer wirft nie, sodass eine Formel nie einen Versand stoppt. \ce{…} stellt Elementzahlen tief, nachgestellte Ladungen hoch und zeichnet -> als Pfeil. Eine leere Notation erzeugt nichts. E-Mail, Live-Ansicht und Posteingang zeichnen dasselbe Bild; nur der Ursprung der URL unterscheidet sich.

<div style="margin:8px 0;text-align:center">
  <img src="https://mailinapp.com/api/formula?d=eyJub3RhdGlvbiI6…&amp;s=…" width="385" height="91"
       alt="x = \frac{-b \pm \sqrt{b^2-4ac}}{2a}"
       style="display:inline-block;max-width:100%;height:auto;vertical-align:middle" />
</div>

Veranstaltungsort

Foto, Name und Adresse sind einfaches HTML, und die Adresse behält ihre Zeilenumbrüche. Der Link zur Wegbeschreibung ist der Google-Maps-Link wie eingefügt, sonst https://maps.google.com/?q=<lat>,<lng>, wenn die Koordinaten nicht null und im gültigen Bereich sind, sonst https://maps.google.com/?q=<Adresse>; ein Maps-API-Schlüssel ist nicht im Spiel. Ohne alle drei wird kein Button gezeichnet. Der Button ist der kugelsichere Button aller Blöcke: ein VML-v:roundrect für das klassische Outlook und ein <a> mit mso-hide:all für alle anderen, beide über den Klick-Slot.

<div style="margin:12px 0">
  <img src="https://example.com/venue.jpg" alt="Grand Hall" style="width:100%;max-width:100%;border-radius:6px;display:block;margin-bottom:10px" />
  <p style="margin:0 0 4px;font-weight:600;font-size:16px;color:#111827">Grand Hall</p>
  <p style="margin:0 0 10px;font-size:14px;color:#4b5563">123 Main St, Springfield</p>
  <!--[if mso]><v:roundrect href="https://mailinapp.com/v/eyJhbGci.../click?blockId=venue-g2&amp;…" …><center>Get Directions</center></v:roundrect><![endif]-->
  <a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=venue-g2&amp;blockType=venue&amp;dest=https%3A%2F%2Fmaps.google.com%2F%3Fq%3D123%2520Main%2520St%252C%2520Springfield&amp;sig=…"
     style="display:inline-block;padding:10px 20px;background-color:#4f46e5;color:#ffffff;border-radius:6px;text-decoration:none;font-size:14px;font-weight:600;mso-hide:all">Get Directions</a>
</div>

Zum Kalender hinzufügen

Die drei Buttons werden nur mit einem gültigen Beginnt am gezeichnet; ein fehlendes Ende oder eines vor dem Beginn wird zu einer Stunde danach. Titel, Beschreibung und Ort werden auf 200, 2.000 und 300 Zeichen gekürzt, bevor ein Link entsteht, sodass die drei immer übereinstimmen. Alle drei teilen sich den einen Klick-Slot des Blocks.

  • .ics herunterladen ist GET /api/calendar, mit dem ganzen Event in der signierten Query (ein HMAC über eine Eingabe mit dem Präfix calendar:, sodass keine andere Familie signierter URLs hier verifiziert, und kein Firestore-Lesezugriff). Es streamt eine RFC-5545-Datei mit DTSTART/DTEND als UTC-Zeitpunkte (ein abschließendes Z, kein VTIMEZONE), sodass jeder Kalender die eigene Zeit des Gastes zeigt. Die UID ist ein SHA-256 der Felder des Events, sodass erneutes Speichern einen Eintrag aktualisiert. Text wird nach §3.3.11 maskiert, und Zeilen werden bei 75 Oktetten gefaltet.
  • Zu Google Calendar hinzufügen ist ein Link calendar.google.com/calendar/render?action=TEMPLATE&… und Zu Outlook.com hinzufügen ein Link outlook.live.com/calendar/0/action/compose?…, beide beim Rendern gebaut.

Mit Nur nach einer Zusage zeigen (afterRsvp) erzeugt die E-Mail nichts; Live-Ansicht, Posteingang und mobile App erzeugen den Block, sobald die aufgezeichnete Zusage des Empfängers in der E-Mail confirmed ist. Die Arbeitsfläche im Studio, die kein Server-Geheimnis hat, zeichnet den .ics-Button mit einem #-Link.

<div style="margin:12px 0">
  <p style="margin:0 0 8px;font-weight:600;font-size:16px;color:#111827">Q3 Product Launch, Webinar</p>
  <p style="margin:0 0 10px;font-size:14px;color:#4b5563">Join us for the big reveal &amp; Q&amp;A.</p>
  <a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=add-to-calendar-g2&amp;blockType=add-to-calendar&amp;dest=https%3A%2F%2Fmailinapp.com%2Fapi%2Fcalendar%3Fd%3D…&amp;sig=…"
     style="display:inline-block;padding:10px 20px;background-color:#4f46e5;color:#ffffff;border-radius:6px;text-decoration:none;font-size:14px;font-weight:600;margin:0 8px 8px 0;mso-hide:all">Download .ics</a>
  <!-- Add to Google Calendar and Add to Outlook.com follow, each through the same click slot -->
</div>

Diagrammblöcke

Die Diagramme, die KPI-Kachel und die Ligatabelle zeichnen nichts auf und enthalten keine Links. Mail, Live-Ansicht und der Posteingang von MailInApp schreiben dasselbe Markup; nur der Ursprung der Bild-URL unterscheidet sich. Jedes Wort, das sie ergänzen (Tabellenüberschriften, die Zonen der Anzeige, die Spalten der Ligatabelle, das zusammengefasste Segment Sonstige), kommt aus emailBlocks.json chart.* und standings.* in der Sprache der E-Mail.

  • Das Bild. Jedes Diagramm und die Sparkline der Kachel sind ein PNG von GET /api/analytics/chart?d=…&s=…&r=2. d ist die ganze Diagrammspezifikation (Typ, Größe, Beschriftungen, Werte, Farben) als base64url-JSON, s ihre HMAC über LIVEVIEW_SECRET und r das Pixelverhältnis. Der Endpunkt liest nichts aus Firestore, eine Antwort ist also eine reine Funktion ihrer signierten Query und trägt einen unveränderlichen Cache-Header; der Edge-Worker zeichnet und liefert sie. Eine Spezifikation über 6.000 Zeichen oder über den Grenzen eines Diagramms wird abgelehnt. Beschriftungen werden vor dem Signieren auf die Beschriftungslänge der Spezifikation gekürzt.
  • Text neben dem Bild. Das alt des <img> nennt das Diagramm und jeden gezeichneten Wert („Bar chart: North (Revenue 12,400); …“). Jedes Diagramm außer der Anzeige lässt eine stets sichtbare <table aria-label="<Titel>"> mit denselben Zahlen folgen, mit einer Legende, wo das Diagramm eine braucht (mehrere Reihen, Segmente, Kacheln oder eine Farbskala). Die Tabelle nennt, was das Bild zeichnet, außer beim Sankey-Diagramm, dessen Tabelle jeden eingetragenen Fluss nennt.
  • Gebundene Diagramme. Die KPI-Kachel und das Balken-, Linien- und Kreisdiagramm nehmen ein binding. Eine Datenquellen-Verknüpfung wird nach groupByField gruppiert und pro Reihe aggregiert (sum, avg, count, latest; src/lib/charts/aggregate.ts), über die Zeilen der Verknüpfung nach dem filter des Blocks, dessen Werte Empfänger-Merge-Tags enthalten dürfen. Eine @response:-Verknüpfung liest den Ergebnis-Rollup des Projekts (src/lib/charts/responseSource.ts). Beide werden beim Rendern aufgelöst: in Mail beim Versand, in der Live-Ansicht bei jedem Laden. Ein Filter mit Empfänger-Tag ergibt eine Spezifikation und damit eine Bild-URL pro Empfänger.
  • Leere Daten. Ein Diagramm ohne verwendbare Zeilen schreibt seinen Titel und einen Hinweis (chart.emptyRows und verwandte Schlüssel) statt des Bildes, sodass ein halb fertiger Block keinen Versand stoppt.
DiagrammTabellenspaltenGrenzen
Balken, Linie, NetzKategorie, dann eine pro benannter Reihe24 Kategorien, 3 Reihen; Netz 3 bis 8 Achsen
Kreis, TreemapKategorie, Wert, Prozent8 Segmente: die 7 größten plus Sonstige
StreudiagrammReihe, X, Y und Größe im Blasendiagramm120 Punkte, 8 Reihen
HistogrammBereich, Anzahl500 Werte, 2 bis 20 Klassen
HeatmapZeile, Spalte, Wert (nur eingetragene Zellen)12 Zeilen × 24 Spalten
TrichterStufe, Wert, % der ersten, % der vorherigen8 Stufen
WasserfallBeschriftung, Wert, Typ, Laufende Summe8 Balken
SankeyVon, Nach, Wert12 Knoten, 24 Verbindungen

Eine Zeile über einer Grenze wird weggelassen, nie zusammengelegt, außer den kleinsten Segmenten des Kreisdiagramms und der Treemap. Trichter und Wasserfall behalten die eingetragene Reihenfolge, die ihre Bedeutung ist.

Diagramme mit Tabelle

<div style="margin:0;padding:0;background-color:#ffffff">
  <p style="margin:0 0 8px;font-weight:600;font-size:15px;color:#111827">Revenue by region</p>
  <img src="https://mailinapp.com/api/analytics/chart?d=eyJ0eXBlIjoiYmFyIi…&amp;s=Ev3iTLfo…&amp;r=2" width="560" height="280"
       alt="Bar chart: North (Revenue 12,400); South (Revenue 9,800); East (Revenue 14,200)"
       style="display:block;max-width:100%;height:auto;margin:8px 0" />
  <table aria-label="Revenue by region" style="width:100%;border-collapse:collapse;margin-top:4px">
    <tr><th scope="col" style="text-align:left;padding:4px 8px;font-size:12px;color:#6b7280;font-weight:600">Category</th>
        <th scope="col" style="text-align:left;padding:4px 8px;font-size:12px;color:#6b7280;font-weight:600">Revenue</th></tr>
    <tr><td style="text-align:left;padding:4px 8px;font-size:12px;color:#6b7280">North</td>
        <td style="text-align:left;padding:4px 8px;font-size:12px;color:#6b7280">12,400</td></tr>
    <!-- one row per category -->
  </table>
</div>

KPI-Kachel

Beschriftung, Wert (als Zahl, US-Dollar oder Prozent formatiert) und Veränderung sind Text. Die Veränderung erscheint nur, wenn previousValue und trendDirection beide gesetzt sind: Der Prozentsatz wird aus den beiden Werten berechnet, Pfeil und Statusfarbe (steigend grün, fallend rot, gleichbleibend gelb) folgen der eingetragenen Richtung. Das Sparkline-Bild braucht mindestens zwei Punkte und nimmt bis zu 60; seine Farbe folgt der des Pfeils. Eine gedämpfte Zeile wiederholt das Ergebnis als Text für Screenreader und den Nur-Text-Teil.

GET /api/v1/liveview/[token] gibt der mobilen App diese Wörter als zusätzliche Props mit, berechnet von denselben kpiDisplay/gaugeDisplay wie in Mail (attachChartImageUrls, src/lib/liveview/chartImages.ts): displayValue, displayChange/displayChangeColor oder displayStatus/displayStatusColor, displaySummary und displayNotice für eine Anzeige ohne Zahl. Jedes andere Diagramm bekommt chartTable, die stets sichtbare Tabelle als JSON {headers, rows}, aus demselben Markup gelesen.

<div style="margin:0;padding:0;background-color:#ffffff">
  <p style="margin:0 0 4px;font-weight:600;font-size:13px;color:#6b7280">Monthly revenue</p>
  <p style="margin:0 0 6px;font-weight:700;font-size:32px;color:#111827">$48,210  <span style="font-size:14px;font-weight:600;color:#16a34a">▲ +17.6%</span></p>
  <img src="https://mailinapp.com/api/analytics/chart?d=eyJ0eXBlIjoic3BhcmtsaW5lIi…&amp;s=…&amp;r=2" width="160" height="40"
       alt="Trend sparkline, upward: 10, 14, 12, 18, 22, 27" style="display:block;max-width:100%;height:auto;margin:4px 0" />
  <p style="margin:4px 0 0;font-size:11px;color:#6b7280">Monthly revenue — $48,210 — ▲ +17.6% vs previous</p>
</div>

Tachodiagramm

Die Anzeige ist das einzige Diagramm ohne Tabelle: Wert und Zone stehen als Text neben ihr. Standardmäßig steigen die Zonen: value <= goodMax ist gut, <= warningMax Warnung, alles darüber kritisch, in den Statusfarben des Themes. Mit higherIsBetter ist value >= goodMin gut, >= warningMin Warnung und alles darunter kritisch; das Bild zeichnet weiter drei aufsteigende Bänder (gaugeSpecBands in src/lib/charts/gauge.ts übergibt warningMin und goodMin mit vertauschter Gut- und Kritisch-Farbe), das signierte Format bleibt also gleich. Die drei Props haben keine Standardwerte, eine Anzeige ohne sie wird wie bisher verschickt. min >= max oder Schwellen in falscher Reihenfolge werden begrenzt statt abgelehnt. Ein Wert, der sich nicht als Zahl lesen lässt (etwa ein nicht aufgelöstes Merge-Tag), schreibt chart.emptyGauge statt der Anzeige.

<div style="margin:0;padding:0;background-color:#ffffff">
  <p style="margin:0 0 4px;font-weight:600;font-size:13px;color:#6b7280">Score</p>
  <p style="margin:0 0 6px;font-weight:700;font-size:32px;color:#111827">72  <span style="font-size:14px;font-weight:600;color:#d97706">Warning</span></p>
  <img src="https://mailinapp.com/api/analytics/chart?d=eyJ0eXBlIjoiZ2F1Z2Ui…&amp;s=…&amp;r=2" width="320" height="200"
       alt="Gauge: 72 of 0–100 (Warning)" style="display:block;max-width:100%;height:auto;margin:8px 0" />
  <p style="margin:4px 0 0;font-size:11px;color:#6b7280">Score — 72 (Warning) — scale 0–100</p>
</div>

Ligatabelle

Eine einfache <table> ohne Bild. Die Zeilen werden mit einer stabilen Sortierung absteigend nach Punkte sortiert, Gleichstände behalten also die eingetragene Reihenfolge; die ersten drei Plätze zeigen 🥇🥈🥉. showDraws: false entfernt die Spalte U aus der Kopfzeile und jeder Zeile. highlightTeamName findet eine Mannschaft ohne Rücksicht auf Groß- und Kleinschreibung und setzt ihre Zeile fett und getönt. Ohne Mannschaft wird standings.empty geschrieben.

<table aria-label="Standings" style="width:100%;border-collapse:collapse">
  <tr><th scope="col" style="text-align:left;padding:4px 8px;font-weight:600">#</th>
      <th scope="col" style="text-align:left;padding:4px 8px;font-weight:600">Team</th>
      <!-- P, W, D, L, PF, PA -->
      <th scope="col" style="padding:4px 8px;text-align:right;font-weight:600">Pts</th></tr>
  <tr><td style="text-align:left;padding:4px 8px">🥇 1</td>
      <td style="text-align:left;padding:4px 8px">Eagles</td>
      <!-- 10, 7, 2, 1, 24, 10 -->
      <td style="padding:4px 8px;text-align:right">23</td></tr>
</table>

Verwandte Seiten