Onde o limite de caracteres do alt text do LinkedIn está escrito de fato

Qual é o limite de caracteres do alt text do LinkedIn?

Duas páginas da referência de API do LinkedIn fixam o limite de caracteres do alt text do LinkedIn em 4.086 caracteres, e as duas acrescentam a recomendação de ficar abaixo de 120. A linha de schema do altText na Images API diz, palavra por palavra: "The alternate text of this thumbnail. Used for screen reader accessibility. Maximum length is 4,086 characters, recommended length is less than 120 characters."

É essa a regra inteira. Um teto rígido, um alvo suave, e uma distância de quase quatro mil caracteres entre os dois.

O campo viaja com o corpo do post, não com o upload. Você o anexa dentro de content.media quando cria o 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"
}

O id ali é a URN de imagem que você recebe de volta da chamada initializeUpload que registra um upload de imagem. O alt text e o binário da imagem chegam ao LinkedIn por duas chamadas diferentes, e só a segunda carrega a descrição.

Recomendado versus máximo

Comprimento recomendado120 caracteres

Comprimento máximo4.086 caracteres

Que páginas do LinkedIn publicam um limite e quais ficam caladas?

Quatro lugares documentam o altText ou seu equivalente. Dois trazem o número. Dois não.

Página	Campo	O que diz sobre comprimento
Schema da Images API	altText	"Maximum length is 4,086 characters, recommended length is less than 120 characters"
Schema da MultiImage API	altText	A frase idêntica, palavra por palavra
Post API Schema, registro Media	altText	"The alternate text for the media. None if empty. Optional." Sem limite
LinkedIn Help, alt text para acessibilidade	A caixa Alt.text	Nenhuma contagem de caracteres publicada

Essa terceira linha é a que derruba as pessoas. A Posts API é onde você de fato envia o campo, e a página de schema da Posts API descreve o altText sem teto. Se você ler só a página que corresponde à chamada que está fazendo, sai de lá acreditando que o campo é ilimitado. O número mora na página da Images API, que é a página sobre upload, não sobre publicação.

A repetição na MultiImage importa por outra razão. O número 4.086 fica no campo altText do próprio registro MultiImage, a única descrição que cobre o conjunto inteiro. Ao lado dele corre um array images com "Minimum of 2 images and maximum of 20 images," e cada entrada desse array é um registro Media que carrega um altText próprio, documentado na página do Post API Schema sem teto nenhum.

O que a API do LinkedIn devolve quando o altText é longo demais?

O LinkedIn não publica a resposta. Essa é a versão honesta, e vale dizer com clareza em vez de chutar.

Eis o que a documentação de fato contém. A tabela de erros da Posts API lista um erro de comprimento:

Status HTTP	Código de erro	Descrição documentada
400	FIELD_LENGTH_TOO_LONG	"{field} length exceeds the allowed maximum. Reduce the length of the commentary or other text fields."

O modelo nomeia commentary e depois acena para "other text fields." Ele nunca nomeia o altText. Enquanto isso, a Images API tem sua própria tabela de erros, e toda entrada nela é sobre identidade em vez de comprimento: INVALID_IMAGE_ID ("This Image ID is invalid"), INVALID_URN_ID, INVALID_URN_TYPE e NOT_FOUND, todas em 400. Nenhum erro de comprimento aparece ali.

Existe uma terceira página de erros, a referência de resposta de erro da Marketing API, que detalha o FIELD_LENGTH_TOO_LONG como "{field} length {length} can't exceeded maximum {max} length" com campo, comprimento e máximo preenchidos. Essa página se limita numa nota: o schema padronizado está "available for adCampaignGroups, adCampaigns and adAccounts endpoints only." Ou seja, a única mensagem de erro precisa o bastante para ser citada vem de endpoints que nada têm a ver com imagens.

Construa o seu editor para validar em 4.086 do seu lado. A alternativa é descobrir a resposta real do LinkedIn em produção, e nenhuma página te diz de antemão com o que ela se parece.

O app do LinkedIn aplica o mesmo limite?

O LinkedIn não publica limite de caracteres para a caixa de alt text no app. O artigo de ajuda "Add alternative text to images for accessibility" percorre os dois fluxos e nunca menciona contagem: no desktop você "click on Alt.text below the image to write a description of the image/photo," no celular você "tap ALT below the image." Esse artigo foi atualizado pela última vez três anos atrás.

O mesmo artigo acrescenta um comportamento sem equivalente na 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."

O lado da publicidade é o exemplo mais afiado do silêncio. A página de especificação de anúncios de imagem única do LinkedIn publica um máximo de caracteres para quatro campos separados: o nome do anúncio em 255 caracteres, o texto introdutório com máximo de 3.000 caracteres e 150 recomendados para evitar corte, o título com máximo de 200 caracteres e 70 recomendados, e a descrição com máximo de 300 caracteres e 100 recomendados. A linha logo abaixo delas diz "Image alt text (optional)" e descreve para que serve o alt text, sem número anexado.

Ou seja, numa mesma tabela o LinkedIn se compromete por escrito com quatro limites e pula o quinto. Quem cita um número de alt text dentro do app está citando algo que o LinkedIn não publicou.

Como o limite de alt text do LinkedIn se compara ao do Instagram?

Quatro vezes mais longo, e com escopo diferente.

Plataforma	Campo	Máximo documentado	Recomendado	Escopo
LinkedIn	altText	4.086 caracteres	Abaixo de 120	Mídia de imagem em posts e posts com múltiplas imagens
Instagram	alt_text	1.000 caracteres	Nenhum publicado	Imagens únicas e imagens dentro de um carrossel

O número da Meta e suas exclusões estão detalhados no texto sobre o limite de 1.000 caracteres de alt_text da Meta no Instagram, incluindo a exceção de reels e stories, então não faz sentido repetir aqui. A diferença estrutural é o que importa: a Meta publica um teto e nenhuma recomendação, o LinkedIn publica os dois, e nenhuma das duas publica limite para o campo que o próprio app mostra a usuários comuns.

Se você escreve uma descrição e a empurra para várias redes por um fluxo que posta em várias contas de uma vez, a restrição que manda é a da plataforma que documenta o menor número. Para um par LinkedIn e Instagram, são 1.000.

Que comprimento o alt text do LinkedIn deve ter?

Abaixo de 120 caracteres, pela recomendação do próprio LinkedIn, e o teto de 4.086 existe para as imagens em que 120 não bastam.

É essa a forma útil de ler os dois números juntos. Uma fotografia de duas pessoas num evento precisa de uma frase. Uma captura de tela de um painel, um gráfico com eixos rotulados, uma tabela de preços, uma agenda de evento, um slide com texto denso sobre a imagem: esses precisam da transcrição, e a recomendação não é regra, é uma dica sobre do que a maioria das imagens precisa.

Comece pelo sujeito e pela ação, acrescente o cenário e depois transcreva qualquer texto visível no quadro em vez de parafraseá-lo. Pule "imagem de" e "foto de", já que leitores de tela já anunciam que há uma imagem. Deixe a voz de marketing no campo commentary, onde ela pertence, e deixe o alt text descrever o que está no quadro.

Uma nota prática sobre dimensionamento, já que alt text e specs de imagem são planejados juntos: as regras de corte que decidem o que sobrevive no feed são uma pergunta separada, coberta no guia sobre dimensões de imagem do LinkedIn para cada tipo de post. O alt text descreve a imagem que o LinkedIn renderiza, não o arquivo que você subiu.

Perguntas frequentes

Qual o comprimento máximo do altText na API do LinkedIn?

4.086 caracteres. As linhas de schema da Images API e da MultiImage API descrevem o altText como "the alternate text of this thumbnail," com "Maximum length is 4,086 characters, recommended length is less than 120 characters."

A documentação da Posts API declara o limite de alt text?

Não. O Post API Schema descreve o altText no seu registro Media como "The alternate text for the media. None if empty. Optional," sem teto. A cifra de 4.086 aparece nas páginas da Images API e da MultiImage API.

Que erro o LinkedIn devolve quando o alt text passa do limite?

O LinkedIn não documenta nenhum para o altText. A tabela de erros da Posts API lista FIELD_LENGTH_TOO_LONG em 400 com a descrição "{field} length exceeds the allowed maximum. Reduce the length of the commentary or other text fields," e a tabela de erros da Images API não carrega erro de comprimento algum.

Existe limite de caracteres na caixa de alt text do app do LinkedIn?

O LinkedIn não publica nenhum. O artigo de ajuda sobre adicionar texto alternativo descreve os fluxos de desktop e de celular sem declarar uma contagem, e a página de especificação de anúncios de imagem única lista máximos de caracteres para quatro campos de anúncio enquanto deixa a linha do alt text sem um.

Dá para definir alt text em cada imagem de um post com múltiplas imagens no LinkedIn?

Sim. A MultiImage API recebe um array images com "Minimum of 2 images and maximum of 20 images," cada uma um registro Media carregando seu próprio campo altText. O máximo de 4.086 caracteres está documentado no altText do próprio registro MultiImage, a descrição do conjunto inteiro, enquanto os de cada imagem estão documentados sem limite.

Em que passo você envia o altText, no upload ou no post?

No post. A chamada initializeUpload e o upload do binário movem o arquivo, e o altText viaja no objeto content.media da requisição POST /rest/posts que referencia a URN de imagem resultante.

O LinkedIn adiciona alt text automaticamente se você não escrever nenhum?

O LinkedIn pode atribuir alt text por conta própria quando uma imagem é publicada sem descrição. Uploads feitos no computador mostram um aviso quando isso acontece, mas uploads feitos no celular não, então a descrição pode acabar sendo escrita pelo LinkedIn em vez de por você.

Quantos campos de alt text um post com múltiplas imagens completo no LinkedIn precisa?

Um post completo com 20 imagens carrega até 21. Um altText fica no próprio registro MultiImage, cobrindo o conjunto, e é esse o campo que o LinkedIn limita a 4.086 caracteres. Cada uma das 20 entradas Media carrega então um altText próprio, que o Post API Schema documenta sem limite nenhum.

A página de especificações de anúncios do LinkedIn define um limite de caracteres para o alt text?

A especificação de anúncios de imagem única lista máximos de caracteres para o nome do anúncio, o texto introdutório, o título e a descrição, quatro campos ao todo. A linha do alt text da imagem aparece logo abaixo desses limites e descreve para que serve o alt text sem atribuir nenhum número a ele.

O alt text do LinkedIn deve descrever o arquivo original ou a versão cortada?

Ele deve descrever o que o LinkedIn realmente exibe no feed, não o arquivo como foi enviado. As regras de corte decidem o que sobra da imagem original, e o alt text precisa condizer com esse enquadramento final visível.