Warum Embed-Limits vor dem Veröffentlichen wichtig sind
Discord-Embed-Payloads wirken oft unproblematisch, bis ein Feld still über eine Zeichenbegrenzung rutscht oder eine Nachricht zu viele Embeds oder Buttons gleichzeitig tragen soll.
Das fällt meist erst spät auf, wenn der Text schon fertig ist. Wer die Struktur früh prüft, spart Nacharbeit und verhindert kaputte Ankündigungen.
- Ein einzelnes zu langes Feld kann eine sonst gute Payload unbrauchbar machen.
- Das Gesamtbudget der Nachricht zählt, nicht nur ein einzelner Titel oder eine Beschreibung.
- Auch Buttons und Action Rows haben strukturelle Grenzen, die vor dem Launch geprüft werden sollten.
Die wichtigsten Text-Limits, die du kennen solltest
Die signalstärksten Grenzen liegen meist bei Titel, Beschreibung, Footer, Author-Name sowie Feldname und Feldwert. An diesen Stellen brechen aufwendige Nachrichten am häufigsten.
Zusätzlich gibt es ein kombiniertes Textbudget über mehrere Embeds hinweg. Mehrere Embeds sind also kein kostenloser Ausweg aus allen Limits.
- Titel sollten kurz und gut scanbar bleiben.
- Beschreibungen tragen den größten Textblock, haben aber trotzdem eine Obergrenze.
- Felder sind stark, doch Feldname und Feldwert haben jeweils eigene Limits.
- Mehrere Embeds brauchen am Ende trotzdem einen gemeinsamen Budget-Check.
Die konkreten Limits in Zahlen
Hier sind die genauen Grenzen, die Discord für ein einzelnes Embed durchsetzt. Der Titel ist auf 256 Zeichen begrenzt, die Beschreibung auf 4.096, jeder Feldname auf 256 und jeder Feldwert auf 1.024, der Footer-Text auf 2.048 und der Author-Name auf 256. Ein Embed darf höchstens 25 Felder enthalten, und eine einzelne Nachricht kann bis zu 10 Embeds tragen.
Die Grenze, über die viele stolpern, ist die kombinierte: Über alle Embeds derselben Nachricht hinweg darf der gesamte Text in Titeln, Beschreibungen, Feldnamen, Feldwerten, Footern und Author-Namen 6.000 Zeichen nicht überschreiten. Eine Nachricht mit einer 4.096 Zeichen langen Beschreibung hat also nur noch rund 1.900 Zeichen für alles andere übrig, egal wie du sie auf Embeds verteilst. Wer eine einzelne Grenze oder die 6.000 insgesamt überschreitet, lässt die ganze Payload scheitern — Discord kürzt nicht höflich.
- Titel 256 · Beschreibung 4.096 · Feldname 256 · Feldwert 1.024 · Footer 2.048 · Author 256.
- Bis zu 25 Felder pro Embed und bis zu 10 Embeds pro Nachricht.
- Kombinierte Grenze: 6.000 Zeichen über alle Embeds einer Nachricht — über dem Limit heißt abgelehnt, nicht gekürzt.
Mehrere Embeds und Buttons brauchen Struktur
Mehrere Embeds helfen, wenn ein einzelner Block zu dicht wird, aber sie brauchen weiterhin Hierarchie. Lesende sollten verstehen, warum es ein zweites Embed gibt und nicht nur einen übergroßen Textblock.
Buttons sollten pro Nachricht nur klare nächste Schritte abbilden. Zu viele Buttons oder gemischte Prioritäten machen die Payload schwerer lesbar.
- Nutze mehrere Embeds, um Übersicht, Details und Follow-up-Aktion zu trennen.
- Halte Button-Zeilen auf wenige klare Aktionen fokussiert.
- Betrachte Buttons als Workflow-Schritte, nicht als Dekoration.
Eine praktische Checkliste vor dem Veröffentlichen
Vor dem Posten eines Webhooks solltest du zuerst die Informationshierarchie und danach die Limits prüfen. Eine Payload, die technisch gültig ist, aber schlecht lesbar bleibt, erzeugt trotzdem Support- und Moderationsaufwand.
Der einfachste Ablauf ist: Text schreiben, Felder und Buttons ergänzen und danach einmal gezielt auf Länge, Struktur und Handlungsaufforderung prüfen.
- Prüfe jedes Embed einzeln auf Titel, Beschreibung, Author, Footer und Felder.
- Prüfe danach die Nachricht als gemeinsame Payload.
- Kontrolliere zuletzt, ob die Buttons auf die richtigen nächsten Schritte verweisen.
Wann du ein Payload besser aufteilst
Nicht jede Webhook-Nachricht sollte zu einem noch größeren Embed-Stapel werden. Wenn Lesende zu verschiedenen Zeitpunkten unterschiedliche Aktionen brauchen, ist ein übergroßes Payload oft schwerer zu scannen als zwei kleinere Posts oder ein Embed plus Follow-up.
Aufteilen ist meistens die bessere Wahl, wenn Status, Erklärung, Changelog-Details und mehrere Handlungsaufforderungen in einer einzigen Nachricht zusammenlaufen.
- Bleib bei einem Embed, wenn die Nachricht nur eine klare Aufgabe oder ein klares Update trägt.
- Nutze mehrere Embeds nur dann, wenn jedes Embed eine eigene Rolle hat, etwa erst Zusammenfassung und dann Details.
- Greif lieber zu einer Nachfolge-Nachricht, wenn Zusatzinformationen die Hauptaktion verwässern würden.
- Prüfe nach dem Aufteilen erneut, ob jede Button-Zeile weiterhin eindeutig wirkt.