Meta setzt das alt_text-Zeichenlimit der Instagram API auf 1.000

Was ist das alt_text-Zeichenlimit der Instagram API?

Metas eigene Referenz setzt das alt_text-Zeichenlimit der Instagram API auf 1.000 Zeichen und beschränkt das Feld auf Standbilder. Die Parameterbeschreibung am Endpunkt für die Medienerstellung lautet Wort für Wort: „Alternative text, up to 1000 character, for an image. Only supported on a single image or image media in a carousel. Reels and stories are not supported."

Ein Satz, drei getrennte Regeln. Die Obergrenze liegt bei 1.000. Das Feld gehört zu einem Bild, entweder allein stehend oder innerhalb eines Karussells. Reels und Stories sind namentlich ausgeschlossen. Alles andere, was Leute über Instagram-Alt-Text glauben, stammt aus einer anderen Quelle als diesem Satz.

Das Feld sitzt am Aufruf zur Container-Erstellung:

POST https://graph.facebook.com/v25.0/<IG_ID>/media
  ?image_url=https://example.com/photo.jpg
  &alt_text=A%20hand-drawn%20site%20plan%20pinned%20to%20a%20studio%20wall
  &caption=Week%20four
  &access_token=<TOKEN>

Du übergibst alt_text bei der Erstellung des Containers, nicht beim Veröffentlichen. Der Publish-Schritt, POST /<IG_ID>/media_publish, nimmt eine creation_id und sonst nichts, was Barrierefreiheit berührt. Wer das Feld am Container vergisst, bekommt im selben Ablauf keine zweite Chance.

Meta datiert die Funktion genau. Der Leitfaden zum Content Publishing hält fest: „On March 24, 2025, we introduced the new alt_text field for image posts on the /<INSTAGRAM_PROFESSIONAL_ACCOUNT_ID>/media endpoint. Reels and stories are not supported." Alles, was vor diesem Datum über Instagrams Publishing-API geschrieben wurde, beschreibt eine Welt ganz ohne programmatischen Alt-Text.

Vorher und nachher: 24. März 2025

Vorher

• Kein alt_text-Feld in der Publishing-API
• Keine programmatische Möglichkeit, Bildbeschreibungen zu setzen

Nachher

• alt_text-Feld im Media-Endpoint verfügbar
• Bis zu 1.000 Zeichen, nur für Bilder

Welche Instagram-Medientypen akzeptieren alt_text?

Nur Bilder. Hier das vollständige Raster, gezogen aus der Parameterbeschreibung und der Liste der Medientypen auf derselben Referenzseite.

Container	alt_text akzeptiert	Was die Dokumentation sagt
Einzelbild (kein media_type nötig)	Ja	„Only supported on a single image"
Bild in einem Karussell (is_carousel_item=true)	Ja	„or image media in a carousel"
Karussell-Container (media_type=CAROUSEL)	Nein	Das Feld beschreibt ein Bild, und der Container hält Kinder, keine Pixel
media_type=REELS	Nein	„Reels and stories are not supported"
media_type=STORIES	Nein	„Reels and stories are not supported"
Video	Nicht aufgeführt	Der Parameter ist auf „for an image" begrenzt, kein Video-Container ist als Empfänger dokumentiert

Lies die letzte Zeile genau, denn sie wird am häufigsten falsch zitiert. Meta schreibt nirgends die Worte „video is not supported". Meta schreibt, der Parameter sei alternativer Text „for an image", und benennt Reels und Stories als die Ausnahmen. Dieser Endpunkt veröffentlicht eigenständiges Video als REELS, was der Satz direkt ausschließt. Das praktische Ergebnis deckt sich mit der Kurzfassung, die alle wiederholen, aber die Dokumentation kommt über den Geltungsbereich dorthin und nicht über ein Verbot, und eine Spec-Seite sollte sagen, welches von beidem gilt.

Warum weicht die Zahl in der App von der Zahl in der API ab?

Metas Entwicklerdokumentation veröffentlicht genau ein Alt-Text-Limit: 1.000 Zeichen, am Parameter alt_text. Für das Alt-Text-Feld in der Instagram-App veröffentlicht sie kein Limit.

Das ist die Lücke, die man benennen sollte. Barrierefreiheits-Leitfäden und Social-Media-Blogs verbreiten eine viel kürzere In-App-Zahl, zitiert ohne Link zurück zu Meta. Diese Zahl taucht in Metas Entwicklerdokumentation nirgends auf, und im Changelog steht sie ebenso wenig, dort gibt es überhaupt keinen Eintrag zu alt_text. Deshalb wiederholt diese Seite sie nicht. Wer wissen will, wie viele Zeichen der Composer in der App fasst, bekommt von Meta die Antwort, dass Meta dazu nichts sagt.

Was du stattdessen bekommst, ist eine harte Zahl für die eine Oberfläche, die sich selbst dokumentiert. Wenn dein Alt-Text über die API läuft, sind 1.000 Zeichen das Budget, und es ist das einzige Budget, auf das Meta sich schriftlich festlegt. Die Beschränkung, um die herum Leute planen, ist am Ende nicht die, die existiert.

Wie verhält sich das alt_text-Limit zum Caption-Limit?

Dieselbe Referenzseite dokumentiert beides, der Vergleich passt also.

Feld	Obergrenze	Zusätzliche Regeln
alt_text	1.000 Zeichen	Nur Bilder. Keine Reels, keine Stories
caption	2.200 Zeichen	Maximal 30 Hashtags und 20 @-Tags

Metas Beschreibung der Caption ist bei den Tag-Zahlen eindeutig: „Maximum 2200 characters, 30 hashtags, and 20 @ tags." Die Beschreibung von alt_text trägt keine vergleichbaren Unterregeln. Kein Hashtag-Limit ist dokumentiert, kein Erwähnungslimit, keine Behandlung von Markup. Es ist ein einfaches Textfeld mit einer Obergrenze.

Diese Asymmetrie zählt, wenn du einen Composer baust. Ein Caption-Validator braucht drei Zähler. Ein Alt-Text-Validator braucht einen, plus eine Prüfung, welchen Medientyp die Person gewählt hat.

Wohin gehört alt_text in einem Karussell-Post?

An jeden Kind-Container, einzeln. Ein Karussell baust du in zwei Stufen. Zuerst ein Container pro Element mit is_carousel_item=true, dann das Elternteil mit media_type=CAROUSEL und einem children-Array dieser IDs. Metas Hinweis zu is_carousel_item lautet: „Applies only to images and video. Set to true. Indicates image or video appears in a carousel."

Alt-Text hängt auf Kind-Ebene, was aus der Parameterbeschreibung folgt, die „image media in a carousel" abdeckt. Zehn Slides bedeuten zehn separate alt_text-Werte, geschrieben für zehn separate Bilder. Es gibt kein Feld auf Elternebene, das das Set beschreibt, und keine Möglichkeit, einen String zu schreiben, der den ganzen Swipe abdeckt. Teams, die Karussells über ein Planungstool für Instagram im Stapel verarbeiten, merken das sofort. Die Alt-Text-Arbeit skaliert mit der Zahl der Slides, nicht mit der Zahl der Posts.

Video-Kinder in einem Karussell erben dasselbe Geltungsbereichsproblem wie eigenständiges Video. Der Kind-Container akzeptiert is_carousel_item, aber alt_text ist für Bildmedien dokumentiert.

Was passiert mit Alt-Text bei Reels und Stories?

Nichts, denn das Feld existiert dort nicht. Schickst du alt_text an einen REELS- oder STORIES-Container, schickst du einen Parameter, den der Endpunkt nicht dokumentiert. Es gibt keine teilweise Unterstützung, kein Abschneiden, keinen Rückfall auf die Caption.

Das lässt ein echtes Loch für alle, die über die Instagram-Posting-API Video in großem Umfang veröffentlichen. Die barrierefreie Beschreibung muss woanders leben, was in der Praxis Caption, Text im Bild oder fest ins Video eingebrannte Untertitel bedeutet. Das sind redaktionelle Entscheidungen, keine API-Felder, und sie gehören in den Content-Kalender, mit dem dein Team ohnehin arbeitet.

Wie nutzt man 1.000 Zeichen tatsächlich aus?

Die meisten Alt-Texte brauchen sie nicht, und Länge ist nicht das Ziel. Der Wert, die echte Obergrenze zu kennen, liegt darin, dass sie den falschen Grund für Knappheit beseitigt. Wenn ein Foto ein Diagramm, eine Speisekarte, eine Preisliste, einen Zeitplan oder dichten Text im Bild trägt, wählst du nicht mehr zwischen Beschreibung und Zusammenfassung. Du hast Platz für beides.

Bei einem dichten Bild beginnst du mit dem Motiv und dem, was es tut, dann folgt die Umgebung, dann jeder im Bild sichtbare Text, transkribiert statt paraphrasiert. Lass „Bild von" und „Foto von" weg, denn assistive Technik kündigt das Element bereits an. Halte die Markenstimme in der Caption, wo ein KI-Caption-Writer diese Aufgabe übernimmt, und lass den Alt-Text beschreiben, was da ist.

Die eine Zahl, um die herum du planst, ist 1.000, pro Container, nur Bilder. Alles andere zum Thema Instagram-Alt-Text ist entweder redaktionelles Urteilsvermögen oder ein undokumentiertes App-Verhalten, auf das Meta sich schriftlich nicht festgelegt hat.

Häufig gestellte Fragen

Wie lang darf alt_text in der Instagram API maximal sein?

1.000 Zeichen. Metas Referenz zum Endpunkt für die Medienerstellung beschreibt den Parameter als „Alternative text, up to 1000 character, for an image", und das ist die einzige Alt-Text-Obergrenze, die in der Entwicklerdokumentation veröffentlicht ist.

Unterstützt die Instagram API alt_text bei Reels?

Nein. Metas Dokumentation stellt klar fest, dass „Reels and stories are not supported" für das Feld alt_text gilt, sowohl in der Parameterbeschreibung als auch im Launch-Hinweis des Leitfadens zum Content Publishing.

Kann man für jede Slide eines Instagram-Karussells Alt-Text setzen?

Ja, an jedem Kind-Container. Die Parameterbeschreibung deckt „image media in a carousel" ab, du übergibst alt_text also zusammen mit is_carousel_item=true, wenn du jedes Bild-Kind erstellst, bevor du den Eltern-Container CAROUSEL zusammensetzt.

Ist das Alt-Text-Limit der Instagram-App dasselbe wie das der API?

Metas Entwicklerdokumentation veröffentlicht kein Zeichenlimit für das Alt-Text-Feld in der Instagram-App, die beiden lassen sich also nicht aus einer zitierbaren Quelle vergleichen. Die Zahl von 1.000 Zeichen gilt für den API-Parameter alt_text.

Wann hat Instagram alt_text zur Publishing-API hinzugefügt?

Am 24. März 2025. Der Leitfaden zum Content Publishing hält das Startdatum fest und begrenzt es auf Bild-Posts am Endpunkt /<INSTAGRAM_PROFESSIONAL_ACCOUNT_ID>/media.

Zählt alt_text zum Instagram-Caption-Limit?

Nein. Es sind separate Parameter mit separaten Obergrenzen am selben Container: caption erlaubt 2.200 Zeichen mit maximal 30 Hashtags und 20 @-Tags, alt_text erlaubt 1.000 Zeichen ohne dokumentierte Unterregeln.

Kann man alt_text über die API zu einem eigenständigen Video-Post hinzufügen?

Video gehört nicht zu den Containern, die alt_text akzeptieren. Die Parameterbeschreibung grenzt das Feld auf „für ein Bild" ein, und dieser Endpunkt veröffentlicht eigenständige Videos über einen REELS-Container, einen der beiden Typen, die die Dokumentation namentlich ausschließt.

In welchem Schritt des Publishing-Flows setzt man alt_text?

Man übergibt alt_text beim Erstellen des Containers im ersten POST an /<IG_ID>/media, nicht beim Publish-Schritt. Der Aufruf media_publish nimmt nur eine creation_id entgegen, es gibt also keine zweite Chance, Alt-Text nachträglich anzuhängen, wenn der Container ohne ihn erstellt wurde.

Was passiert, wenn man alt_text trotzdem an einen Reels- oder Stories-Container schickt?

Nichts Nützliches, weil der Endpunkt das Feld für diese Container-Typen nicht dokumentiert. Metas Referenz beschreibt weder eine Teilunterstützung noch eine Kürzung noch einen Rückfall auf die Caption.

Hat das alt_text-Feld Zusatzregeln wie das Caption-Feld?

Hat es nicht. Das Caption-Parameter dokumentiert eine Obergrenze von 30 Hashtags und 20 @-Erwähnungen zusätzlich zum Zeichenlimit, während die alt_text-Beschreibung nichts davon enthält, nur die Obergrenze von 1.000 Zeichen und die Beschränkung auf Bilder.