Où est vraiment écrite la limite de caractères du texte alternatif LinkedIn

Quelle est la limite de caractères du texte alternatif LinkedIn ?

Deux pages de la référence API de LinkedIn fixent la limite de caractères du texte alternatif LinkedIn à 4 086 caractères, et toutes deux ajoutent une recommandation de rester sous 120. La ligne de schéma de l'Images API pour altText se lit, mot pour mot : « The alternate text of this thumbnail. Used for screen reader accessibility. Maximum length is 4,086 characters, recommended length is less than 120 characters. »

C'est toute la règle. Un plafond dur, une cible souple, et un écart de près de quatre mille caractères entre les deux.

Le champ voyage avec le corps du post, pas avec l'envoi du fichier. Vous l'attachez dans content.media au moment de créer le post :

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"
}

L'id ici est l'URN d'image que vous renvoie l'appel initializeUpload qui enregistre un envoi d'image. Le texte alternatif et le binaire de l'image arrivent chez LinkedIn par deux appels différents, et seul le second porte la description.

Recommandé face au maximum

Longueur recommandée120 caractères

Longueur maximale4 086 caractères

Quelles pages de LinkedIn publient une limite, et lesquelles se taisent ?

Quatre endroits documentent altText ou son équivalent. Deux portent le chiffre. Deux non.

Page	Champ	Ce qu'elle dit de la longueur
Schéma de l'Images API	altText	« Maximum length is 4,086 characters, recommended length is less than 120 characters »
Schéma de la MultiImage API	altText	La phrase identique, mot pour mot
Post API Schema, enregistrement Media	altText	« The alternate text for the media. None if empty. Optional. » Aucune limite
Aide LinkedIn, texte alternatif pour l'accessibilité	Le champ Alt.text	Aucun compte de caractères publié

C'est la troisième ligne qui fait trébucher. La Posts API est l'endroit où vous envoyez réellement le champ, et la page de schéma de la Posts API décrit altText sans plafond. Si vous ne lisez que la page correspondant à l'appel que vous faites, vous en ressortez convaincu que le champ est illimité. Le chiffre vit sur la page de l'Images API, qui parle d'envoi de fichiers, pas de publication.

La répétition côté MultiImage compte pour une autre raison. Le chiffre de 4 086 porte sur le champ altText de l'enregistrement MultiImage lui-même, la seule description qui couvre tout l'ensemble. À côté court un tableau images avec un « Minimum of 2 images and maximum of 20 images », et chaque entrée de ce tableau est un enregistrement Media portant un altText bien à lui, documenté sur la page Post API Schema sans le moindre plafond.

Que renvoie l'API LinkedIn quand altText est trop long ?

LinkedIn ne publie pas la réponse. C'est la version honnête, et elle vaut mieux dite franchement que devinée.

Voici ce que la documentation contient. Le tableau d'erreurs de la Posts API liste une erreur de longueur :

Statut HTTP	Code d'erreur	Description documentée
400	FIELD_LENGTH_TOO_LONG	« {field} length exceeds the allowed maximum. Reduce the length of the commentary or other text fields. »

Le modèle nomme commentary puis fait un geste vague vers « other text fields. » Il ne nomme jamais altText. Pendant ce temps, l'Images API a son propre tableau d'erreurs, et chaque entrée y porte sur l'identité plutôt que sur la longueur : INVALID_IMAGE_ID (« This Image ID is invalid »), INVALID_URN_ID, INVALID_URN_TYPE et NOT_FOUND, toutes en 400. Aucune erreur de longueur n'y apparaît.

Il existe une troisième page d'erreurs, la référence des réponses d'erreur de la Marketing API, qui détaille FIELD_LENGTH_TOO_LONG en « {field} length {length} can't exceeded maximum {max} length » avec le champ, la longueur et le maximum remplis. Cette page pose son propre périmètre dans une note : le schéma standardisé est « available for adCampaignGroups, adCampaigns and adAccounts endpoints only. » Donc le seul message d'erreur assez précis pour être cité vient d'endpoints qui n'ont rien à voir avec les images.

Construisez votre éditeur pour valider à 4 086 de votre côté. L'autre option est de découvrir la vraie réponse de LinkedIn en production, et aucune page ne vous dit d'avance à quoi elle ressemble.

L'application LinkedIn applique-t-elle la même limite ?

LinkedIn ne publie aucune limite de caractères pour le champ de texte alternatif de l'application. L'article d'aide « Add alternative text to images for accessibility » parcourt les deux parcours sans jamais mentionner un compte : sur ordinateur vous « click on Alt.text below the image to write a description of the image/photo », sur mobile vous « tap ALT below the image. » Cet article a été mis à jour pour la dernière fois il y a trois ans.

Le même article ajoute un comportement auquel l'API n'a aucun équivalent : « 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. »

Le côté publicitaire est l'exemple le plus net de ce silence. La page de spécifications des publicités à image unique de LinkedIn publie un maximum de caractères pour quatre champs distincts : le nom de la publicité à 255 caractères, le texte d'introduction à 3 000 caractères maximum avec 150 recommandés pour éviter la troncature, le titre à 200 caractères maximum avec 70 recommandés, et la description à 300 caractères maximum avec 100 recommandés. La ligne juste en dessous dit « Image alt text (optional) » et décrit à quoi sert le texte alternatif, sans aucun chiffre attaché.

Donc dans un même tableau, LinkedIn s'engage par écrit sur quatre limites et saute la cinquième. Quiconque cite un chiffre pour le texte alternatif dans l'application cite quelque chose que LinkedIn n'a pas publié.

Comment la limite de LinkedIn se compare-t-elle à celle d'Instagram ?

Quatre fois plus longue, et d'un périmètre différent.

Plateforme	Champ	Maximum documenté	Recommandé	Périmètre
LinkedIn	altText	4 086 caractères	Sous 120	Médias image sur les posts et les posts multi-images
Instagram	alt_text	1 000 caractères	Aucun publié	Images seules et images dans un carrousel

Le chiffre de Meta et ses exclusions sont détaillés dans l'analyse de la limite de 1 000 caractères d'alt_text de Meta sur Instagram, y compris l'exclusion des reels et des stories, il n'y a donc aucun intérêt à la répéter ici. C'est la différence de structure qui compte : Meta publie un plafond et aucune recommandation, LinkedIn publie les deux, et aucun des deux ne publie de limite pour le champ que leur propre application montre aux utilisateurs ordinaires.

Si vous rédigez une description unique et que vous la poussez vers plusieurs réseaux par un flux qui publie sur plusieurs comptes à la fois, la contrainte qui mord est celle de la plateforme au plus petit chiffre documenté. Pour une paire LinkedIn et Instagram, c'est 1 000.

Quelle longueur le texte alternatif LinkedIn devrait-il vraiment faire ?

Sous 120 caractères, selon la recommandation de LinkedIn lui-même, et le plafond de 4 086 existe pour les images où 120 ne suffisent pas.

C'est la façon utile de lire les deux chiffres ensemble. Une photo de deux personnes à une conférence demande une phrase. Une capture d'un tableau de bord, un graphique aux axes légendés, une grille tarifaire, un programme d'événement, une diapositive au texte dense : ceux-là demandent la transcription, et la recommandation n'est pas une règle, c'est une indication sur ce dont la plupart des images ont besoin.

Commencez par le sujet et l'action, ajoutez le cadre, puis transcrivez le texte visible dans l'image plutôt que de le paraphraser. Sautez les « image de » et « photo de », puisque les lecteurs d'écran annoncent déjà la présence d'une image. Gardez la voix marketing dans le champ commentary, là où elle appartient, et laissez le texte alternatif décrire ce qui est dans l'image.

Une note pratique sur le dimensionnement, puisque le texte alternatif et les specs d'image se planifient ensemble : les règles de recadrage qui décident de ce qui survit dans le fil sont une autre question, traitée dans le guide sur les dimensions des images LinkedIn pour chaque type de post. Le texte alternatif décrit l'image que LinkedIn affiche, pas le fichier que vous avez envoyé.

Questions fréquentes

Quelle est la longueur maximale d'altText sur l'API LinkedIn ?

4 086 caractères. Les lignes de schéma de l'Images API et de la MultiImage API décrivent toutes deux altText comme « the alternate text of this thumbnail », avec « Maximum length is 4,086 characters, recommended length is less than 120 characters. »

La documentation de la Posts API indique-t-elle la limite de texte alternatif ?

Non. Le Post API Schema décrit altText dans son enregistrement Media comme « The alternate text for the media. None if empty. Optional », sans plafond. Le chiffre de 4 086 apparaît sur les pages de l'Images API et de la MultiImage API à la place.

Quelle erreur LinkedIn renvoie-t-il quand le texte alternatif dépasse la limite ?

LinkedIn n'en documente aucune pour altText. Le tableau d'erreurs de la Posts API liste FIELD_LENGTH_TOO_LONG en 400 avec la description « {field} length exceeds the allowed maximum. Reduce the length of the commentary or other text fields », et le tableau d'erreurs de l'Images API ne porte aucune erreur de longueur.

Y a-t-il une limite de caractères sur le champ de texte alternatif de l'application LinkedIn ?

LinkedIn n'en publie aucune. L'article d'aide sur l'ajout de texte alternatif décrit les parcours ordinateur et mobile sans indiquer de compte, et la page de spécifications des publicités à image unique liste des maximums de caractères pour quatre champs publicitaires tout en laissant la ligne du texte alternatif sans chiffre.

Peut-on définir un texte alternatif pour chaque image d'un post multi-images LinkedIn ?

Oui. La MultiImage API prend un tableau images avec un « Minimum of 2 images and maximum of 20 images », chacune étant un enregistrement Media portant son propre champ altText. Le maximum de 4 086 caractères est documenté sur le champ altText de l'enregistrement MultiImage lui-même, la description de l'ensemble, tandis que ceux de chaque image sont documentés sans limite.

À quelle étape envoie-t-on altText, l'envoi du fichier ou le post ?

Le post. L'appel initializeUpload et l'envoi du binaire déplacent le fichier, et altText voyage dans l'objet content.media de la requête POST /rest/posts qui référence l'URN d'image obtenu.

LinkedIn ajoute-t-il automatiquement un texte alternatif si vous n'en saisissez pas ?

LinkedIn peut attribuer lui-même un texte alternatif quand une image est publiée sans description. Un envoi depuis un ordinateur déclenche une alerte dans ce cas, mais un envoi depuis un mobile n'en déclenche aucune, si bien que la description peut finir rédigée par LinkedIn plutôt que par vous.

Combien de champs de texte alternatif faut-il pour un post multi-images complet sur LinkedIn ?

Un post complet de 20 images en porte jusqu'à 21. Un altText se trouve sur l'enregistrement MultiImage lui-même et couvre l'ensemble, et c'est ce champ que LinkedIn plafonne à 4 086 caractères. Chacune des 20 entrées Media porte ensuite son propre altText, que le Post API Schema documente sans limite.

La page de spécifications publicitaires de LinkedIn fixe-t-elle une limite de caractères pour le texte alternatif ?

La spécification des annonces à image unique indique des maximums de caractères pour le nom de l'annonce, le texte d'introduction, le titre et la description, quatre champs au total. La ligne du texte alternatif de l'image se trouve juste en dessous de ces limites et décrit à quoi sert le texte alternatif sans lui attacher de chiffre.

Le texte alternatif LinkedIn doit-il décrire le fichier d'origine ou la version recadrée ?

Il doit décrire ce que LinkedIn affiche réellement dans le fil, pas le fichier tel qu'envoyé. Les règles de recadrage déterminent ce qui subsiste de l'image d'origine, et le texte alternatif doit correspondre à ce cadrage final visible.