So fügst du Mastodon-Alt-Text in der Web-App und per API hinzu

Was ist Mastodon-Alt-Text?

Wer Mastodon-Alt-Text schreibt, füllt die Medienbeschreibung aus, die jeder Anhang eines Mastodon-Beitrags trägt, ein Feld in reinem Text, das Screenreader anstelle von Bild, Video oder Audio vorlesen. Der Posting-Leitfaden von Mastodon sagt, diese Beschreibungen „will be shown when the media fails to load for any reason, or when accessed by screen readers and other assistive technology.“

Die Beschreibung gehört zum Medienanhang, nicht zum Beitragstext. Wenn du eine Datei anhängst, lädt Mastodon sie als eigenes Anhangsobjekt hoch, und die Beschreibung wird an diesem Objekt neben seinem Fokuspunkt gespeichert. Ein Beitrag fasst auf mastodon.social bis zu 4 Anhänge, ein Beitrag mit vier Fotos trägt also vier separate Beschreibungen.

Die API-Dokumentation definiert das Feld in einem Satz: „A plain-text description of the media, for accessibility purposes.“ Reiner Text heißt: keine Links, Erwähnungen oder Formatierung in der Beschreibung.

Wie fügst du auf Mastodon Alt-Text zu einem Bild hinzu?

Du fügst Alt-Text in der Mastodon-Web-App hinzu, indem du auf den Button ALT oder Edit an einem angehängten Bild klickst, die Beschreibung im Dialog „Add alt text“ eingibst und vor dem Posten auf Done klickst. Die Schritte in Mastodon 4.7:

1. Öffne den Editor und hänge eine Bild-, Video- oder Audiodatei an.
2. Sieh dir das Vorschaubild an. In seiner Ecke sitzt ein ALT-Button, der ein Warnsymbol zeigt, solange die Datei keine Beschreibung hat.
3. Klicke auf ALT oder oben in der Ecke auf Edit. Beide öffnen denselben Dialog.
4. Gib die Beschreibung in das Textfeld ein. Es zeigt bei Bildern „Describe this for people with visual impairments“ und bei Audio und Video „Describe this for people with hearing impairments“.
5. Enthält ein Bild Text, klicke auf „Add text from image“. Mastodon füllt das Feld dann mit dem Text, den es aus dem Bild liest, und du korrigierst ihn.
6. Klicke auf Done. Das Warnsymbol verschwindet vom ALT-Button.
7. Wiederhole das für jeden Anhang und klicke dann auf Post.

Im selben Dialog setzt du den Fokuspunkt, also die Stelle, die Mastodon im Blick behält, wenn es das Vorschaubild zuschneidet. Mastodon-Apps von Drittanbietern platzieren das Beschreibungsfeld an eigenen Stellen, schreiben aber alle in dasselbe Feld description am Anhang.

Wie lang darf Mastodon-Alt-Text sein?

Mastodon-Alt-Text darf so lang sein wie das description_limit deines Servers, das der Code von Mastodon bis Version 4.5 auf 1,500 Zeichen und ab Version 4.6 auf 10,000 Zeichen setzt. Jeder Server läuft mit seiner eigenen Mastodon-Version, das Limit hängt also vom Server ab, über den du postest, nicht von Mastodon als Ganzem.

Mastodon-Version	Beschreibungslimit im Code	Wo du es siehst
4.2 bis 4.3	1,500 Zeichen	Nicht in der API veröffentlicht
4.4 bis 4.5	1,500 Zeichen	description_limit in /api/v2/instance
4.6 und neuer	10,000 Zeichen	description_limit in /api/v2/instance

Das Limit steht im Quellcode von Mastodon in MediaAttachment::MAX_DESCRIPTION_LENGTH, und der Server lehnt eine längere Beschreibung seiner eigenen Nutzer ab. Die Dokumentation der Instance-Entität zeigt in ihrer Beispielantwort noch 1,500, während mastodon.social am 9. Oktober 2026 mit einem Nightly-Build von 4.8 den Wert 10,000 meldete. Ab Mastodon 4.6 zählt der Zeichenzähler im Web-Editor bis 10,000.

Lange Beschreibungen sind erlaubt, nicht vorgeschrieben. Beschreibe, was das Bild zeigt und welcher Text darin steht, und hör dann auf. Der Beitragstext hat sein eigenes Limit, das das Mastodon-Zeichenlimit erklärt, und eine Beschreibung zählt nicht dagegen.

Wie prüfst du das Alt-Text-Limit deines Servers?

Du prüfst das Alt-Text-Limit eines Servers, indem du configuration.media_attachments.description_limit aus seiner Antwort auf GET /api/v2/instance ausliest, wofür keine Anmeldung nötig ist. Die Dokumentation der Instance-Entität beschreibt das Feld als „The maximum size of a description, in characters,“ und führt es als hinzugefügt in Mastodon 4.4.0.

Öffne https://your.server/api/v2/instance im Browser und suche im JSON nach description_limit. Ein Server mit 4.3 oder älter lässt das Feld in der Antwort weg, erzwingt im Code aber trotzdem 1,500 Zeichen. Derselbe Block listet die Größenlimits des Servers für Bilder und Videos und seine unterstützten Dateitypen, eine Anfrage beantwortet also beides: wie lang die Beschreibung sein darf und ob die Datei hochgeladen wird.

Wie sendest du Alt-Text über die Mastodon API?

Du sendest Alt-Text über die Mastodon API als Formularfeld description bei POST /api/v2/media, dem Aufruf, der die Datei hochlädt, bevor du sie an einen Beitrag hängst. Alle Stellen, an denen das Feld vorkommt:

Aufruf	Was er mit der Beschreibung macht
POST /api/v2/media	Setzt die Beschreibung beim Hochladen der Datei
PUT /api/v1/media/:id	Ändert sie „before it is attached to a status and posted“
PUT /api/v1/statuses/:id	Ändert sie nach dem Posten über media_attributes[][], ein Array, das „includes id, description, and focus“

Der Upload-Aufruf gibt einen Medienanhang mit einer id zurück, und diese id übergibst du in media_ids[], wenn du den Status erstellst. Kleine Bilder kommen mit HTTP 200 zurück und sind sofort bereit. Video, Video im GIF-Stil und Audio kommen mit 202 zurück und werden im Hintergrund fertig verarbeitet, ein Client wartet also vor dem Posten auf die Verarbeitung. Planst du über die API, legt die 5-Minuten-Regel für Mastodon scheduled_at fest, wie nah an jetzt ein Beitrag in die Warteschlange darf, und Medien samt Beschreibung hängen auf dieselbe Weise am geplanten Beitrag.

Warum erwartet die Mastodon-Kultur Alt-Text?

Die Mastodon-Kultur erwartet Alt-Text, weil die Software selbst bei jedem Schritt danach fragt: Der Editor markiert unbeschriebene Medien, ein Bestätigungsdialog unterbricht das Posten, und Leser sehen, welche Bilder eine Beschreibung haben. Diese Standards prägen, was Nutzer als normal empfinden.

Die Signale, auf die ein Mastodon-Nutzer trifft:

• Die ALT-Warnung. Ein Anhang ohne Beschreibung zeigt im Editor ein Warnsymbol auf seinem ALT-Button.
• Die Prüfung beim Posten. Ein Klick auf Post mit unbeschriebenen Medien öffnet „Add alt text?“ mit der Nachricht „Your post contains media without alt text. Adding descriptions helps make your content accessible to more people.“ Du wählst „Add alt text“ oder „Post anyway“.
• Der Standard. Die Prüfung steuert „Warn me before posting media without alt text“ unter Preferences, dann Appearance, und sie ist für jedes neue Konto eingeschaltet.
• Das ALT-Badge. Beschriebene Bilder zeigen in der Timeline ein ALT-Badge, und ein Klick darauf öffnet die Beschreibung, Leser sehen also auf einen Blick, wer sie weggelassen hat.
• Die Doku. Der Posting-Leitfaden nennt Beschreibungen optional, sagt aber „it is a good idea to add media descriptions that briefly describe what is in contained in the media.“

Das Ergebnis ist ein Netzwerk, in dem ein Foto ohne Beschreibung auffällt. Wer von Netzwerken kommt, die das Alt-Feld tiefer verstecken, muss sich vor allem daran gewöhnen, und der Vergleich Mastodon vs Bluesky behandelt die übrigen Unterschiede. Die allgemeinen Gewohnheiten, Bilder zu beschreiben, Videos zu untertiteln und Kontraste lesbar zu halten, gelten in jedem Netzwerk, und Barrierefreiheit in Social Media geht sie durch.

Was passiert, wenn du Medien ohne Beschreibung postest

Datei anhängen

Warnsymbol am ALT-Button

Auf Post klicken

Dialog „Add alt text?“

Add alt text oder Post anyway

Wie fügst du Mastodon-Alt-Text zu geplanten Beiträgen hinzu?

Ein Scheduler fügt Mastodon-Alt-Text hinzu, indem er jedes Bild mit deiner Beschreibung im Feld description auf deinen Server hochlädt und die Uploads beim Veröffentlichen an den Beitrag hängt. AdaptlyPost macht das über einen Button „Add alt text“ an jedem Bild im Editor, mit einem Dialog, der dich bittet: „Describe the image for people who use screen readers.“

Der Mastodon-Post-Scheduler postet auf jeden Mastodon-Server: Du gibst deine Serveradresse ein, etwa mastodon.social, und meldest dich dort an. Jeder Beitrag nimmt bis zu 4 Bilder, jedes mit eigenem Alt-Text, und bei einem Videobeitrag wartet AdaptlyPost, bis dein Server die Datei fertig verarbeitet hat, bevor es postet. Der Editor und die AdaptlyPost API nehmen bis zu 1,000 Zeichen pro Beschreibung an, was unter jedes Limit in der Tabelle oben passt. Der Hinweis des Editors am Alt-Text-Feld lautet „Sent to X, Bluesky, Mastodon, LinkedIn, Facebook, Instagram and Threads,“ eine Beschreibung pro Bild geht also an jedes Netzwerk im Beitrag, das eine annimmt.

Häufig gestellte Fragen

Wie füge ich auf Mastodon Alt-Text hinzu?

Hänge im Editor eine Datei an, klicke auf den Button ALT oder Edit an ihrem Vorschaubild, gib die Beschreibung ein und klicke auf Done. Das Warnsymbol auf dem ALT-Button verschwindet, sobald die Datei eine Beschreibung hat. Wiederhole das für jeden Anhang, bevor du auf Post klickst.

Wie hoch ist das Zeichenlimit für Mastodon-Alt-Text?

Das Limit legt jeder Server als description_limit in /api/v2/instance fest. Der Code von Mastodon setzte bis Version 4.5 1,500 Zeichen und ab Version 4.6 10,000, die Zahl hängt also von der Version ab, die dein Server nutzt. mastodon.social meldete am 9. Oktober 2026 den Wert 10,000.

Ist Alt-Text auf Mastodon Pflicht?

Nein. Mastodon nimmt Beiträge ohne Medienbeschreibung an, und der Posting-Leitfaden nennt sie optional. Die Web-App zeigt vor dem Posten unbeschriebener Medien einen Dialog „Add alt text?“, und diese Warnung ist unter Preferences, dann Appearance, standardmäßig eingeschaltet.

Kann man Mastodon-Alt-Text nach dem Posten bearbeiten?

Ja, über die API. PUT /api/v1/statuses/:id nimmt media_attributes[][] mit id, Beschreibung und Fokus des Anhangs, ein Client mit Bearbeitungsfunktion ändert die Beschreibung also an einem veröffentlichten Beitrag. Vor dem Posten ändert PUT /api/v1/media/:id sie an einem noch nicht angehängten Upload.

Was bedeutet das ALT-Badge auf Mastodon-Bildern?

Das ALT-Badge bedeutet, dass die Person, die gepostet hat, eine Beschreibung für diesen Anhang geschrieben hat. Ein Klick darauf öffnet den Beschreibungstext. Bilder ohne Beschreibung zeigen kein Badge.

Sendet AdaptlyPost Alt-Text an Mastodon?

Ja. AdaptlyPost sendet den Alt-Text, den du für jedes Bild schreibst, zusammen mit dem Upload an deinen Mastodon-Server, bis zu 4 Bilder pro Beitrag. Jede Beschreibung kann im Editor und in der API bis zu 1,000 Zeichen lang sein, was unter beide Limits im Code von Mastodon passt, 1,500 und 10,000.

Zählt Alt-Text zum Zeichenlimit von Mastodon?

Die Beschreibung zählt nicht zum Zeichenlimit des Beitrags. Beitragstext und jede Medienbeschreibung haben getrennte Limits. Das Limit für Beschreibungen legt dein Server als description_limit fest.

Wie schalte ich die Alt-Text-Warnung von Mastodon aus?

Öffne Preferences, dann Appearance, und deaktiviere „Warn me before posting media without alt text“. Die Einstellung ist für jedes neue Konto standardmäßig aktiv. Ist sie aus, postet Mastodon Medien ohne Beschreibung, ohne den Dialog „Add alt text?“ zu zeigen.

Kann Mastodon-Alt-Text Links oder Hashtags enthalten?

Nicht als funktionierende Links oder Hashtags. Die API definiert die Beschreibung als „A plain-text description of the media, for accessibility purposes.“ Reiner Text heißt: keine Links, Erwähnungen oder Formatierung in der Beschreibung.

Wie füge ich bei Mastodon Alt-Text zu einem Video oder einer Audiodatei hinzu?

Hänge die Datei an, klicke auf dem Vorschaubild auf ALT oder Edit, tippe die Beschreibung und klicke auf Done. Das Textfeld für Audio und Video lautet „Describe this for people with hearing impairments“. Über die API geben Video- und Audio-Uploads 202 zurück und werden im Hintergrund verarbeitet, deshalb wartet ein Client vor dem Posten.