Dónde está escrito realmente el límite de caracteres del texto alternativo de LinkedIn

¿Cuál es el límite de caracteres del texto alternativo de LinkedIn?

Dos páginas de la referencia de la API de LinkedIn fijan el límite de caracteres del texto alternativo de LinkedIn en 4.086 caracteres, y las dos añaden la recomendación de quedarse por debajo de 120. La fila de esquema de altText en la Images API dice, palabra por palabra: "The alternate text of this thumbnail. Used for screen reader accessibility. Maximum length is 4,086 characters, recommended length is less than 120 characters."

Esa es toda la regla. Un techo duro, un objetivo blando y un hueco de casi cuatro mil caracteres entre los dos.

El campo viaja con el cuerpo de la publicación, no con la subida. Lo adjuntas dentro de content.media cuando creas el 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"
}

El id de ahí es el URN de imagen que te devuelve la llamada initializeUpload que registra la subida de una imagen. El texto alternativo y el binario de la imagen llegan a LinkedIn por dos llamadas distintas, y solo la segunda lleva la descripción.

Recomendado frente a máximo

Longitud recomendada120 caracteres

Longitud máxima4.086 caracteres

¿Qué páginas de LinkedIn publican un límite y cuáles callan?

Cuatro sitios documentan altText o su equivalente. Dos llevan el número. Dos no.

Página	Campo	Qué dice sobre la longitud
Esquema de la Images API	altText	"Maximum length is 4,086 characters, recommended length is less than 120 characters"
Esquema de la MultiImage API	altText	La frase idéntica, palabra por palabra
Post API Schema, registro Media	altText	"The alternate text for the media. None if empty. Optional." Sin límite
LinkedIn Help, texto alternativo para accesibilidad	La casilla Alt.text	Ningún recuento de caracteres publicado

Esa tercera fila es la que hace tropezar a la gente. La Posts API es donde realmente envías el campo, y la página de esquema de la Posts API describe altText sin techo. Si lees solo la página que corresponde a la llamada que estás haciendo, te vas creyendo que el campo no tiene límite. El número vive en la página de la Images API, que es la página sobre subir, no sobre publicar.

La repetición en MultiImage importa por otro motivo. La cifra de 4.086 está en el campo altText del propio registro MultiImage, la única descripción que cubre el conjunto entero. Junto a él corre un array images con un "Minimum of 2 images and maximum of 20 images," y cada entrada de ese array es un registro Media que lleva su propio altText, documentado en la página del Post API Schema sin ningún techo.

¿Qué devuelve la API de LinkedIn cuando altText es demasiado largo?

LinkedIn no publica la respuesta. Esa es la versión honesta, y conviene decirlo claro en lugar de adivinar.

Esto es lo que sí contiene la documentación. La tabla de errores de la Posts API lista un error de longitud:

Estado HTTP	Código de error	Descripción documentada
400	FIELD_LENGTH_TOO_LONG	"{field} length exceeds the allowed maximum. Reduce the length of the commentary or other text fields."

La plantilla nombra commentary y luego hace un gesto vago hacia "other text fields." Nunca nombra altText. Mientras tanto, la Images API tiene su propia tabla de errores, y todas sus entradas son sobre identidad y no sobre longitud: INVALID_IMAGE_ID ("This Image ID is invalid"), INVALID_URN_ID, INVALID_URN_TYPE y NOT_FOUND, todos con 400. Ahí no aparece ningún error de longitud.

Hay una tercera página de errores, la referencia de respuestas de error de la Marketing API, que detalla FIELD_LENGTH_TOO_LONG como "{field} length {length} can't exceeded maximum {max} length" con el campo, la longitud y el máximo rellenos. Esa página se acota a sí misma en una nota: el esquema estandarizado está "available for adCampaignGroups, adCampaigns and adAccounts endpoints only." Así que el único mensaje de error lo bastante preciso para citarlo viene de endpoints que no tienen nada que ver con imágenes.

Construye tu compositor para validar en 4.086 por tu lado. La alternativa es descubrir la respuesta real de LinkedIn en producción, y ninguna página te dice de antemano qué aspecto tiene.

¿La app de LinkedIn aplica el mismo límite?

LinkedIn no publica ningún límite de caracteres para la casilla de texto alternativo de la app. El artículo de ayuda "Add alternative text to images for accessibility" recorre los dos flujos y no menciona ningún recuento: en escritorio "click on Alt.text below the image to write a description of the image/photo," y en móvil "tap ALT below the image." Ese artículo se actualizó por última vez hace tres años.

El mismo artículo añade un comportamiento sin equivalente en la API: "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."

El lado publicitario es el ejemplo más afilado del silencio. La página de especificaciones de anuncios de imagen única de LinkedIn publica un máximo de caracteres para cuatro campos distintos: el nombre del anuncio en 255 caracteres, el texto introductorio con un máximo de 3.000 caracteres y 150 recomendados para evitar el truncado, el titular con un máximo de 200 caracteres y 70 recomendados, y la descripción con un máximo de 300 caracteres y 100 recomendados. La fila justo debajo dice "Image alt text (optional)" y describe para qué sirve el texto alternativo, sin número alguno.

Así que en una misma tabla LinkedIn compromete cuatro límites por escrito y se salta el quinto. Quien cite una cifra de texto alternativo dentro de la app está citando algo que LinkedIn no ha publicado.

¿Cómo se compara el límite de LinkedIn con el de Instagram?

Cuatro veces más largo, y con otro alcance.

Plataforma	Campo	Máximo documentado	Recomendado	Alcance
LinkedIn	altText	4.086 caracteres	Menos de 120	Medios de imagen en posts y posts de varias imágenes
Instagram	alt_text	1.000 caracteres	Ninguno publicado	Imágenes sueltas e imágenes dentro de un carrusel

El número de Meta y sus exclusiones están cubiertos en detalle en el desglose del límite de 1.000 caracteres de alt_text de Meta en Instagram, incluida la exclusión de reels y stories, así que no tiene sentido repetirlo aquí. Lo que importa es la diferencia estructural: Meta publica un techo y ninguna recomendación, LinkedIn publica los dos, y ninguna de las dos publica un límite para el campo que su propia app enseña a los usuarios corrientes.

Si escribes una sola descripción y la empujas a varias redes mediante un flujo que publica en varias cuentas a la vez, la restricción que manda es la de la plataforma que documente el número más pequeño. Para una pareja de LinkedIn e Instagram, son 1.000.

¿Cuánto debería medir de verdad el texto alternativo de LinkedIn?

Menos de 120 caracteres, por recomendación del propio LinkedIn, y el techo de 4.086 existe para las imágenes en las que 120 no bastan.

Esa es la forma útil de leer los dos números juntos. Una fotografía de dos personas en una conferencia necesita una frase. Una captura de un panel, un gráfico con ejes etiquetados, una tabla de precios, el horario de un evento, una diapositiva con mucho texto encima: esas necesitan la transcripción, y la recomendación no es una regla, es una pista sobre lo que necesitan la mayoría de imágenes.

Empieza por el sujeto y la acción, añade el entorno y luego transcribe el texto visible en la imagen en vez de parafrasearlo. Sáltate "imagen de" y "foto de", porque los lectores de pantalla ya anuncian que hay una imagen. Deja la voz de marketing en el campo commentary, que es donde va, y que el texto alternativo describa lo que hay en el encuadre.

Una nota práctica sobre tamaños, ya que el texto alternativo y las especificaciones de imagen se planifican juntos: las reglas de recorte que deciden qué sobrevive en el feed son otra cuestión, cubierta en la guía de las dimensiones de imagen de LinkedIn para cada tipo de publicación. El texto alternativo describe la imagen que LinkedIn renderiza, no el archivo que subiste.

Preguntas frecuentes

¿Cuál es la longitud máxima de altText en la API de LinkedIn?

4.086 caracteres. Las filas de esquema de la Images API y de la MultiImage API describen las dos altText como "the alternate text of this thumbnail," con "Maximum length is 4,086 characters, recommended length is less than 120 characters."

¿La documentación de la Posts API indica el límite de texto alternativo?

No. El Post API Schema describe altText en su registro Media como "The alternate text for the media. None if empty. Optional," sin techo. La cifra de 4.086 aparece en las páginas de la Images API y la MultiImage API.

¿Qué error devuelve LinkedIn cuando el texto alternativo supera el límite?

LinkedIn no documenta ninguno para altText. La tabla de errores de la Posts API lista FIELD_LENGTH_TOO_LONG con 400 y la descripción "{field} length exceeds the allowed maximum. Reduce the length of the commentary or other text fields," y la tabla de errores de la Images API no lleva ningún error de longitud.

¿Hay límite de caracteres en la casilla de texto alternativo de la app de LinkedIn?

LinkedIn no publica ninguno. El artículo de ayuda sobre añadir texto alternativo describe los flujos de escritorio y móvil sin indicar recuento, y la página de especificaciones de anuncios de imagen única lista máximos de caracteres para cuatro campos del anuncio mientras deja la fila del texto alternativo sin ninguno.

¿Puedes poner texto alternativo a cada imagen de un post de varias imágenes en LinkedIn?

Sí. La MultiImage API lleva un array images con un "Minimum of 2 images and maximum of 20 images," cada una un registro Media con su propio campo altText. El máximo de 4.086 caracteres está documentado en el altText del propio registro MultiImage, la descripción del conjunto entero, mientras que los de cada imagen se documentan sin límite.

¿En qué paso se envía altText, en la subida o en la publicación?

En la publicación. La llamada initializeUpload y la subida del binario mueven el archivo, y altText viaja en el objeto content.media de la petición POST /rest/posts que referencia el URN de imagen resultante.

¿Añade LinkedIn texto alternativo automáticamente si no escribes ninguno?

LinkedIn puede asignar texto alternativo por su cuenta cuando una imagen se sube sin ninguno. Las subidas desde un ordenador de escritorio muestran un aviso cuando esto ocurre, pero las subidas desde un móvil no, así que la descripción puede acabar escrita por LinkedIn en lugar de por ti.

¿Cuántos campos de texto alternativo necesita un post de varias imágenes completo en LinkedIn?

Un post completo de 20 imágenes lleva hasta 21. Un altText está en el propio registro MultiImage y cubre el conjunto, y ese es el campo que LinkedIn limita a 4.086 caracteres. Cada una de las 20 entradas Media lleva después un altText propio, que el Post API Schema documenta sin límite.

¿La página de especificaciones de anuncios de LinkedIn fija un límite de caracteres para el texto alternativo?

La especificación de anuncios de imagen única indica máximos de caracteres para el nombre del anuncio, el texto introductorio, el titular y la descripción, cuatro campos en total. La fila del texto alternativo de la imagen aparece justo debajo de esos límites y explica para qué sirve el texto alternativo sin adjuntarle ningún número.

¿El texto alternativo de LinkedIn debe describir el archivo original o la versión recortada?

Debe describir lo que LinkedIn muestra realmente en el feed, no el archivo tal como se subió. Las reglas de recorte deciden qué sobrevive de la imagen original, y el texto alternativo tiene que coincidir con ese encuadre final visible.