Como escrever bons textos alternativos para imagens (acessibilidade e SEO)

O texto alternativo é a descrição curta de uma imagem armazenada no atributo alt do elemento img, e é a correção de acessibilidade de maior impacto que a maioria dos sites pode fazer. Leitores de tela o leem em voz alta para visitantes cegos e com baixa visão, navegadores o exibem quando uma imagem não carrega, e os buscadores dependem dele para entender o que uma imagem mostra. Também é uma questão legal: o critério de sucesso 1.1.1 das WCAG exige uma alternativa em texto para todo conteúdo não textual no nível de conformidade A, o nível mínimo, e leis como o European Accessibility Act se apoiam exatamente nesses critérios. A boa notícia é que escrever bem um texto alternativo é uma habilidade de minutos, não de semanas. As regras cabem em um cartão: descreva o que importa na imagem dentro do contexto dela, fique em cerca de uma frase concisa, evite expressões como imagem de, dê às imagens puramente decorativas um atributo alt vazio e nunca omita o atributo por completo. Este guia percorre cada regra com exemplos, mostra onde o texto alternativo vive no WordPress e termina explicando como encontrar toda imagem do seu site que ainda está sem um.

O que é texto alternativo e quem depende dele?

No código HTML, o texto alternativo é um atributo do elemento de imagem:

<img src="lighthouse.jpg" alt="Farol listrado de vermelho e branco em uma costa rochosa ao pôr do sol">

Três públicos o consomem, e pensar neles explica quase todas as regras que vêm a seguir. Quem usa leitor de tela ouve o texto alternativo no lugar da imagem, então, para essas pessoas, ele simplesmente é a imagem. Cerca de 2,2 bilhões de pessoas no mundo vivem com alguma forma de deficiência visual, segundo a OMS, e os leitores de tela são a forma como boa parte delas navega. Os navegadores exibem o texto quando a imagem não consegue carregar, o que ainda acontece diariamente em conexões lentas e deploys quebrados. E os rastreadores dos buscadores, que não conseguem ver imagens como as pessoas veem, usam o atributo alt como seu principal sinal textual sobre o conteúdo da imagem.

A exigência formal vem do critério de sucesso 1.1.1 Non-text Content das WCAG. Ele fica no nível de conformidade A, o que significa que um site sem alternativas em texto reprova na barra mais baixa de conformidade de acessibilidade, por melhor que todo o resto esteja feito.

Como escrever um bom texto alternativo: cinco regras que cobrem quase tudo

Texto alternativo é escrita, e como toda escrita ele melhora com algumas restrições. Estas cinco te levam por quase toda imagem:

• Descreva conteúdo e propósito, não pixels. Pergunte o que a imagem comunica neste contexto e diga isso. A mesma foto de uma pessoa diante de um notebook pode ser Agente de suporte respondendo a conversas de clientes em uma página de suporte e Trabalhando na mesa da cozinha em um artigo sobre trabalho remoto.
• Seja específico, mas pare no que for relevante. Cachorro diz menos do que Filhote de golden retriever correndo atrás de uma bola em um gramado. Mas se o artigo é sobre cuidados com o jardim, a raça pode importar menos do que a grama mastigada.
• Fique em torno de uma frase. Uma orientação bastante usada é algo perto de 125 caracteres, uma convenção herdada de leitores de tela antigos que dividiam textos longos em pedaços. Não é um limite rígido, mas é uma boa forma de forçar concisão. Coloque as palavras importantes na frente.
• Evite imagem de e foto de. Os leitores de tela já anunciam o elemento como imagem, então essas expressões são pura repetição. Dizer o tipo só agrega valor quando ele importa: pintura de, captura de tela de e gráfico de orientam quem escuta.
• Para imagens com link ou função, descreva o destino ou a ação. Um logotipo que leva à página inicial deveria dizer Nome da empresa, página inicial, e não descrever a arte do logotipo. Um botão de ícone que envia uma busca deveria dizer Buscar. A função vence a aparência sempre que uma imagem faz alguma coisa.

Um caso especial merece a própria frase: imagens que contêm texto. As WCAG desencorajam texto embutido em imagens já de saída, mas onde ele existir, por exemplo em um banner promocional, o texto alternativo precisa incluir esse texto, porque ele é invisível para todo mundo que depende da alternativa.

Textos alternativos bons e ruins: exemplos comparados

Repare no padrão da coluna fraca: nomes de arquivo, palavras soltas e descrições de pixels em vez de significado. A linha do gráfico mostra a maior distância. Para quem usa leitor de tela, chart não transmite nada, enquanto um resumo de uma linha do achado substitui todo o visual. Se um gráfico for complexo demais para uma linha, resuma a conclusão principal no texto alternativo e ofereça os dados completos em uma tabela ali perto.

Imagens decorativas: quando o texto alternativo vazio é o correto

Nem toda imagem carrega significado. Separadores ornamentais, formas abstratas de fundo e fotos de banco de imagens que só acrescentam clima são decoração, e a marcação correta para elas é um atributo alt vazio:

<img src="divider-ornament.svg" alt="">

O atributo vazio é um sinal deliberado que manda os leitores de tela pularem a imagem inteiramente, que é exatamente o que uma pessoa que enxerga faz na prática. Isso é muito diferente de omitir o atributo: sem nenhum atributo alt, muitos leitores de tela recorrem a anunciar o nome do arquivo, e o visitante ouve grafico barra separador traço ornamento traço final traço v2 ponto svg lido em voz alta no meio da frase. É por isso que os verificadores de acessibilidade sinalizam atributos alt ausentes como erros e tratam os vazios como válidos. O W3C oferece uma prática árvore de decisão para textos alternativos para os casos de fronteira genuínos.

Um teste pragmático para saber se algo é decorativo: imagine a imagem sumindo. Se a página não perde nenhuma informação nem função, o alt vazio está certo. Se algo com significado desaparece, descreva a imagem.

Como adicionar texto alternativo no WordPress

O WordPress dá a toda imagem um campo de texto alternativo, e chegar até ele leva três cliques:

• No editor de blocos: selecione o bloco de imagem, e o campo Texto alternativo aparece na barra lateral de configurações do bloco, em Configurações. Esse é o valor que acaba no HTML da página.
• Na biblioteca de mídia: abra qualquer imagem e preencha o campo Texto alternativo nos detalhes do anexo. Esse valor é usado como padrão quando a imagem for inserida em algum lugar no futuro.
• Para imagens destacadas: o texto alternativo vem do valor daquela imagem na biblioteca de mídia, então as miniaturas dos posts herdam o que estiver guardado ali.

Uma peculiaridade do WordPress é responsável por muita confusão e merece um aviso destacado: atualizar o texto alternativo na biblioteca de mídia não altera imagens que já estão inseridas em posts. O editor de blocos copia o texto alternativo para o conteúdo do post no momento da inserção, e a partir dali a cópia é independente. Se você corrigir textos alternativos na biblioteca de mídia e se perguntar por que as páginas não mudaram, é por isso. As inserções já existentes precisam ser editadas nos próprios posts, ou com uma ferramenta de search-replace se a escala exigir.

Já que você está no fluxo de mídia: o campo de texto alternativo não é o campo de título nem a legenda. O título é sobretudo interno, a legenda é o texto visível abaixo da imagem, e só o atributo alt serve a leitores de tela e rastreadores. Preencher o campo errado é a forma mais comum de um site terminar com legendas bonitas e atributos alt vazios.

Texto alternativo e SEO: o que o Google realmente diz

A documentação de SEO para imagens do Google é inequívoca: texto alternativo descritivo é um fator de ranqueamento no Google Images e ajuda o Google a entender tanto a imagem quanto a página ao redor. Para lojas e sites de conteúdo, a busca por imagens é um canal de tráfego de verdade, e o atributo alt é a alavanca mais direta dela. O mesmo documento traz o aviso igualmente inequívoco: encher atributos alt de palavras-chave resulta em uma experiência ruim para o usuário e pode fazer com que o seu site seja percebido como spam.

A tradução prática: escreva o texto alternativo pensando primeiro em quem escuta e, se o tema da página couber naturalmente na descrição, inclua-o uma vez. Tênis de corrida Nike Air Zoom azul, vista lateral é um bom texto alternativo que por acaso contém as palavras que alguém buscaria numa compra. tenis de corrida comprar tenis de corrida barato melhor tenis de corrida 2026 é spam vestido de atributo alt. Nomes de arquivo descritivos (tenis-corrida-azul.jpg em vez de IMG_4032.jpg) e um texto ao redor que combine com a imagem completam o quadro, mas o texto alternativo continua sendo o sinal mais forte que você controla por inteiro.

Como encontrar imagens sem texto alternativo no seu site

Escrever bons textos alternativos começa por saber onde eles estão faltando, e há ferramentas para toda escala. Para uma única página, o próprio navegador responde direto: abra o console das ferramentas de desenvolvedor e rode uma linha que lista todas as infratoras.

// Lista todas as imagens sem atributo alt na página atual
document.querySelectorAll('img:not([alt])').forEach((img) => console.log(img.src));

Para auditar página por página com retorno visual, a ferramenta gratuita WAVE, da WebAIM marca todo atributo alt ausente ou suspeito direto na página renderizada, e o Lighthouse no Chrome inclui a verificação na auditoria de acessibilidade. A dimensão do problema é bem documentada: a análise anual WebAIM Million, feita sobre as páginas iniciais do primeiro milhão de sites, encontra textos alternativos ausentes entre as falhas de acessibilidade mais comuns ano após ano, em cerca de metade de todas as páginas iniciais testadas. Seja lá o que você encontrar no seu próprio site, você está em vasta companhia e, ao contrário da maioria dos problemas de acessibilidade, este se resolve imagem por imagem, em minutos.

Como o InspectWP verifica seus textos alternativos

Um relatório do InspectWP conta as imagens de uma página analisada e informa, na seção de SEO, quantas trazem um atributo alt e quantas estão sem, sinalizando as ausências como aviso. Isso te dá o inventário de alt ausentes de um site WordPress sem abrir as ferramentas de desenvolvedor e, como os relatórios podem rodar em uma agenda, ele também pega as regressões que inevitavelmente acontecem quando conteúdo novo é publicado com pressa. Combine a contagem do relatório com as regras de escrita deste guia, e o caminho fica curto: encontre as imagens, descreva o que importa, deixe a decoração silenciosamente vazia, e tanto quem usa leitor de tela quanto o seu tráfego de busca por imagens colhem o benefício.