Wo das LinkedIn-Alt-Text-Zeichenlimit tatsächlich steht

Was ist das LinkedIn-Alt-Text-Zeichenlimit?

Zwei Seiten in LinkedIns API-Referenz setzen das LinkedIn-Alt-Text-Zeichenlimit auf 4.086 Zeichen, und beide ergänzen die Empfehlung, unter 120 zu bleiben. Die Schema-Zeile der Images API zu altText lautet Wort für Wort: „The alternate text of this thumbnail. Used for screen reader accessibility. Maximum length is 4,086 characters, recommended length is less than 120 characters."

Das ist die ganze Regel. Eine harte Decke, ein weiches Ziel und fast viertausend Zeichen Abstand dazwischen.

Das Feld reist mit dem Beitragskörper, nicht mit dem Upload. Du hängst es beim Erstellen des Beitrags in content.media an:

POST https://api.linkedin.com/rest/posts
Linkedin-Version: 202608
X-Restli-Protocol-Version: 2.0.0

{
  "author": "urn:li:organization:5515715",
  "commentary": "test strings!",
  "visibility": "PUBLIC",
  "content": {
    "media": {
      "altText": "testing for alt tags",
      "id": "urn:li:image:C5610AQFj6TdYowm17w"
    }
  },
  "lifecycleState": "PUBLISHED"
}

Die id dort ist die Bild-URN, die du aus dem initializeUpload-Aufruf bekommst, der einen Bild-Upload registriert. Alt-Text und Bilddaten erreichen LinkedIn über zwei verschiedene Aufrufe, und nur der zweite trägt die Beschreibung.

Empfehlung im Vergleich zum Maximum

Empfohlene Länge120 Zeichen

Maximale Länge4.086 Zeichen

Welche LinkedIn-Seiten veröffentlichen ein Limit und welche schweigen?

Vier Stellen dokumentieren altText oder sein Gegenstück. Zwei tragen die Zahl. Zwei nicht.

Seite	Feld	Was dort zur Länge steht
Images API Schema	altText	„Maximum length is 4,086 characters, recommended length is less than 120 characters"
MultiImage API Schema	altText	Derselbe Satz, Wort für Wort
Post API Schema, Record Media	altText	„The alternate text for the media. None if empty. Optional." Kein Limit
LinkedIn Hilfe, Alt-Text für Barrierefreiheit	Das Feld Alt.text	Keine Zeichenzahl veröffentlicht

Die dritte Zeile bringt Leute zu Fall. Die Posts API ist die Stelle, an der du das Feld tatsächlich sendest, und die Schema-Seite der Posts API beschreibt altText ohne Decke. Wer nur die Seite liest, die zum eigenen Aufruf passt, hält das Feld für unbegrenzt. Die Zahl lebt auf der Seite der Images API, und die handelt vom Hochladen, nicht vom Posten.

Die Wiederholung bei MultiImage zählt aus einem anderen Grund. Die Zahl 4.086 sitzt am Feld altText des MultiImage-Records selbst, jener einen Beschreibung, die den gesamten Satz abdeckt. Daneben läuft ein images-Array mit „Minimum of 2 images and maximum of 20 images", und jeder Eintrag dieses Arrays ist ein Media-Record mit eigenem altText, dokumentiert auf der Seite des Post API Schema ganz ohne Obergrenze.

Was liefert die LinkedIn API, wenn altText zu lang ist?

LinkedIn veröffentlicht die Antwort nicht. Das ist die ehrliche Fassung, und sie gehört klar gesagt statt geraten.

Das steht in der Dokumentation. Die Fehlertabelle der Posts API führt einen Längenfehler:

HTTP-Status	Fehlercode	Dokumentierte Beschreibung
400	FIELD_LENGTH_TOO_LONG	„{field} length exceeds the allowed maximum. Reduce the length of the commentary or other text fields."

Die Vorlage nennt commentary und winkt dann Richtung „other text fields." Sie nennt altText nie. Die Images API hat derweil ihre eigene Fehlertabelle, und jeder Eintrag darin dreht sich um Identität statt um Länge: INVALID_IMAGE_ID („This Image ID is invalid"), INVALID_URN_ID, INVALID_URN_TYPE und NOT_FOUND, alle bei 400. Ein Längenfehler kommt dort überhaupt nicht vor.

Es gibt eine dritte Fehlerseite, die Referenz zu Fehlerantworten der Marketing API, und die buchstabiert FIELD_LENGTH_TOO_LONG als „{field} length {length} can't exceeded maximum {max} length" mit ausgefüllten Werten für Feld, Länge und Maximum. Diese Seite beschränkt sich in einer Anmerkung selbst: Das standardisierte Schema ist „available for adCampaignGroups, adCampaigns and adAccounts endpoints only." Die einzige Fehlermeldung, die präzise genug zum Zitieren ist, stammt also von Endpunkten, die mit Bildern nichts zu tun haben.

Bau deinen Composer so, dass er auf deiner Seite bei 4.086 prüft. Die Alternative ist, LinkedIns tatsächliche Antwort in der Produktion zu entdecken, und keine Seite sagt dir vorab, wie sie aussieht.

Setzt die LinkedIn-App dasselbe Limit durch?

LinkedIn veröffentlicht für das Alt-Text-Feld in der App kein Zeichenlimit. Der Hilfeartikel „Add alternative text to images for accessibility" führt durch beide Wege und erwähnt nie eine Zahl: Am Desktop sollst du „click on Alt.text below the image to write a description of the image/photo", auf dem Handy „tap ALT below the image." Dieser Artikel wurde zuletzt vor drei Jahren aktualisiert.

Derselbe Artikel ergänzt ein Verhalten, für das die API kein Gegenstück hat: „LinkedIn may automatically add alt-text to images that don't have it. When uploading an image from a desktop computer, you'll be alerted if alt-text is automatically assigned. You won't be alerted if you're uploading an image from a mobile device."

Die Werbeseite ist das schärfere Beispiel für das Schweigen. LinkedIns Spezifikationsseite zu Single Image Ads veröffentlicht ein Zeichenmaximum für vier verschiedene Felder: den Anzeigennamen bei 255 Zeichen, den einleitenden Text bei maximal 3.000 Zeichen mit 150 als Empfehlung gegen Abschneiden, die Überschrift bei maximal 200 Zeichen mit 70 als Empfehlung und die Beschreibung bei maximal 300 Zeichen mit 100 als Empfehlung. Die Zeile direkt darunter lautet „Image alt text (optional)" und beschreibt, wofür Alt-Text da ist, ohne jede Zahl.

In einer Tabelle legt LinkedIn sich also schriftlich auf vier Limits fest und überspringt das fünfte. Wer eine Zahl für Alt-Text in der App zitiert, zitiert etwas, das LinkedIn nicht veröffentlicht hat.

Wie verhält sich LinkedIns Alt-Text-Limit zu dem von Instagram?

Viermal länger, und anders abgegrenzt.

Plattform	Feld	Dokumentiertes Maximum	Empfohlen	Geltungsbereich
LinkedIn	altText	4.086 Zeichen	Unter 120	Bildmedien in Beiträgen und Multi-Image-Beiträgen
Instagram	alt_text	1.000 Zeichen	Keine veröffentlicht	Einzelbilder und Bilder in einem Karussell

Metas Zahl und ihre Ausnahmen behandelt die Aufschlüsselung zu Metas 1.000-Zeichen-Limit für alt_text auf Instagram im Detail, samt der Ausklammerung von Reels und Stories, deshalb gibt es hier keinen Grund zur Wiederholung. Der strukturelle Unterschied ist das Entscheidende: Meta veröffentlicht eine Decke und keine Empfehlung, LinkedIn veröffentlicht beides, und keiner von beiden veröffentlicht ein Limit für das Feld, das die eigene App gewöhnlichen Nutzern zeigt.

Wenn du eine Beschreibung schreibst und sie über einen Ablauf, der mehrere Konten gleichzeitig bespielt, an mehrere Netzwerke schickst, ist die bindende Grenze die kleinste dokumentierte Zahl. Für ein Paar aus LinkedIn und Instagram sind das 1.000.

Wie lang sollte LinkedIn-Alt-Text wirklich sein?

Unter 120 Zeichen, nach LinkedIns eigener Empfehlung, und die Decke von 4.086 existiert für die Bilder, bei denen 120 nicht reichen.

So liest man die beiden Zahlen sinnvoll zusammen. Ein Foto von zwei Menschen auf einer Konferenz braucht einen Satz. Ein Screenshot eines Dashboards, ein Diagramm mit beschrifteten Achsen, eine Preistabelle, ein Veranstaltungsplan, eine Folie mit dichtem Text im Bild: Die brauchen die Abschrift, und die Empfehlung ist keine Regel, sondern ein Hinweis darauf, was die meisten Bilder brauchen.

Beginn mit Motiv und Handlung, ergänze den Schauplatz und schreib dann jeden im Bild sichtbaren Text ab, statt ihn zu umschreiben. Lass „Bild von" und „Foto von" weg, denn Screenreader kündigen ohnehin an, dass ein Bild vorhanden ist. Halt die Marketingstimme im Feld commentary, wo sie hingehört, und lass den Alt-Text beschreiben, was im Bild ist.

Ein praktischer Hinweis zur Größe, weil Alt-Text und Bildspezifikationen zusammen geplant werden: Die Zuschneideregeln, die entscheiden, was im Feed überlebt, sind eine eigene Frage und stehen im Leitfaden zu LinkedIn-Bildmaßen für jeden Beitragstyp. Alt-Text beschreibt das Bild, das LinkedIn rendert, nicht die Datei, die du hochgeladen hast.

Häufig gestellte Fragen

Wie lang darf altText in der LinkedIn API maximal sein?

4.086 Zeichen. Die Schema-Zeilen der Images API und der MultiImage API beschreiben altText beide als „the alternate text of this thumbnail", mit „Maximum length is 4,086 characters, recommended length is less than 120 characters."

Nennt die Dokumentation der Posts API das Alt-Text-Limit?

Nein. Das Post API Schema beschreibt altText in seinem Media-Record als „The alternate text for the media. None if empty. Optional", ohne Decke. Die Zahl 4.086 steht stattdessen auf den Seiten der Images API und der MultiImage API.

Welchen Fehler liefert LinkedIn, wenn der Alt-Text das Limit überschreitet?

LinkedIn dokumentiert für altText keinen. Die Fehlertabelle der Posts API führt FIELD_LENGTH_TOO_LONG bei 400 mit der Beschreibung „{field} length exceeds the allowed maximum. Reduce the length of the commentary or other text fields", und die Fehlertabelle der Images API trägt überhaupt keinen Längenfehler.

Gibt es ein Zeichenlimit für das Alt-Text-Feld in der LinkedIn-App?

LinkedIn veröffentlicht keines. Der Hilfeartikel zum Hinzufügen von alternativem Text beschreibt den Weg am Desktop und am Handy, ohne eine Zahl zu nennen, und die Spezifikationsseite zu Single Image Ads führt Zeichenmaxima für vier Anzeigenfelder auf und lässt die Zeile zum Alt-Text ohne.

Kannst du in einem LinkedIn-Beitrag mit mehreren Bildern jedem Bild Alt-Text geben?

Ja. Die MultiImage API nimmt ein images-Array mit „Minimum of 2 images and maximum of 20 images", und jeder Eintrag ist ein Media-Record mit eigenem Feld altText. Das Maximum von 4.086 Zeichen ist am Feld altText des MultiImage-Records selbst dokumentiert, der Beschreibung für den gesamten Satz, die Felder je Bild dagegen ohne Limit.

In welchem Schritt sendest du altText, beim Upload oder beim Beitrag?

Beim Beitrag. Der Aufruf initializeUpload und der Binär-Upload bewegen die Datei, und altText reist im Objekt content.media der Anfrage POST /rest/posts, die auf die entstandene Bild-URN verweist.

Fügt LinkedIn automatisch Alt-Text hinzu, wenn du keinen einträgst?

LinkedIn kann selbst Alt-Text vergeben, wenn ein Bild ohne eigene Beschreibung hochgeladen wird. Beim Upload vom Desktop aus erscheint dazu ein Hinweis, beim Upload vom Mobilgerät aus nicht, sodass die Beschreibung am Ende von LinkedIn statt von dir stammen kann.

Wie viele Alt-Text-Felder braucht ein vollständiger LinkedIn-Mehrbildbeitrag?

Ein vollständiger Beitrag mit 20 Bildern trägt bis zu 21. Ein altText sitzt am MultiImage-Datensatz selbst und deckt den gesamten Satz ab, und genau dieses Feld deckelt LinkedIn bei 4.086 Zeichen. Jeder der 20 Media-Einträge trägt dann einen eigenen altText, den das Post API Schema ohne Limit dokumentiert.

Legt LinkedIns Anzeigenspezifikation ein Zeichenlimit für Alt-Text fest?

Die Spezifikation für Bildanzeigen mit einem Bild nennt Zeichenmaxima für den Anzeigennamen, den einleitenden Text, die Überschrift und die Beschreibung, insgesamt vier Felder. Die Zeile für den Bild-Alt-Text steht direkt darunter und beschreibt, wofür Alt-Text da ist, ohne eine Zahl dazu zu nennen.

Sollte LinkedIn-Alt-Text die Originaldatei oder die zugeschnittene Version beschreiben?

Er sollte beschreiben, was LinkedIn im Feed tatsächlich anzeigt, nicht die hochgeladene Datei. Zuschnittregeln entscheiden, was vom Originalbild übrig bleibt, und der Alt-Text muss zu diesem finalen, sichtbaren Ausschnitt passen.