← Voltar ao blog
Criação de Sites

Texto alternativo no WordPress: como preencher e testar o atributo alt

Texto alternativo no WordPress: como preencher e testar o atributo alt
Ilustração gerada por IA.

Para adicionar texto alternativo no WordPress, selecione a imagem no editor de blocos, abra suas configurações e preencha o campo Texto alternativo. Escreva a informação que aquela imagem transmite no contexto da página. Depois de salvar, confira o atributo alt da imagem no HTML publicado. O procedimento usa recursos nativos e pode ser realizado sem plugin pago.

Este tutorial trata do editor de blocos e foi preparado com documentação consultada em 19 de novembro de 2026. Os nomes e a posição dos controles podem variar conforme a tradução e a versão instalada. No Elementor ou em outro construtor, localize as opções do respectivo componente de imagem e faça a mesma verificação no resultado final.

O que escrever no texto alternativo

O atributo alt fornece uma alternativa textual para a imagem. A descrição depende da função do elemento. Uma fotografia informativa pede o significado relevante, uma imagem usada como único conteúdo de um link pede a finalidade desse link e um elemento puramente decorativo pode ter alt vazio. Gráficos complexos precisam de explicação equivalente no conteúdo. A árvore de decisão da W3C ajuda a escolher o tratamento adequado.

Exemplo reproduzível com uma fotografia de produto

Abra uma fotografia de uma caneca azul com alça. Em uma página que apresenta a peça, experimente o texto “Caneca azul com alça curva, vista de lado”. Agora imagine a mesma fotografia em uma comparação de formatos de alça. A informação relevante poderia ser “Alça curva com espaço para dois dedos”. São exemplos de redação para testar em uma imagem que realmente mostre essas características.

Confira cada substantivo da descrição olhando a fotografia. Retire atributos que você deduziu, como material, capacidade ou resistência, quando eles não forem demonstrados ou confirmados. O texto pode ser breve e ainda permitir que o leitor compreenda o que importa naquela posição da página.

Antes de editar

Tenha acesso à edição do post e uma imagem cujo uso esteja autorizado. Abra primeiro um rascunho de teste. Anote onde a imagem será utilizada e qual informação o parágrafo ao lado já oferece. Isso ajuda a decidir se a descrição precisa acrescentar algo e evita repetir uma legenda inteira.

Em um portfólio, por exemplo, identifique o detalhe do trabalho que merece ser entendido. A organização das imagens também é abordada no guia sobre como montar um portfólio no site.

Passo a passo no editor de blocos

1. Abra Posts, selecione o artigo e clique em Editar. No ponto desejado, use o botão + para adicionar o bloco Imagem.

2. Escolha Enviar ou Biblioteca de mídia e selecione o arquivo. A documentação do bloco Imagem apresenta essas opções e os controles do bloco.

3. Selecione a imagem inserida. Abra as configurações do bloco e localize Texto alternativo. Preencha a descrição adequada ao contexto.

4. Use a legenda para informação visível, como crédito ou explicação adicional. Revise a imagem na prévia e salve o rascunho ou atualize o post quando estiver pronto.

Imagem existente e biblioteca de mídia

Ao revisar um post antigo, confira a própria ocorrência da imagem no bloco. Uma alteração na biblioteca pode não atualizar o conteúdo já salvo em páginas existentes. A comprovação deve ser feita na página final, principalmente quando o mesmo arquivo aparece em vários lugares ou foi inserido por um construtor.

Como testar o atributo alt no navegador

No Chrome para computador, abra a prévia, clique com o botão direito na imagem e escolha Inspecionar. Localize o elemento img correspondente. Se a seleção cair em figure ou em um contêiner, expanda os elementos até encontrar img. Procure um atributo como alt=”Caneca azul com alça curva, vista de lado”.

Compare o valor com o texto salvo. Se o elemento estiver ligado a uma versão reduzida do arquivo, use também o endereço src para confirmar que você está olhando a imagem certa. Em uma imagem decorativa, verifique a presença explícita de alt=””. A ausência do atributo e um valor vazio são situações diferentes no código.

Faça uma segunda leitura considerando apenas o parágrafo, a legenda e a descrição. Eles devem permitir entender a informação relevante sem depender da visualização da fotografia. Esse exercício ajuda na revisão editorial, mas uma avaliação completa de acessibilidade também considera navegação e tecnologias assistivas.

Erros frequentes e como corrigir

O campo foi alterado, mas a página mostra o valor antigo

Confirme se o post foi salvo, abra a URL correta e recarregue a página. Verifique o bloco específico e confira se o tema ou construtor usa outro arquivo naquela posição. Se houver cache ativo, atualize o cache pelo procedimento já adotado no site e repita a inspeção.

A descrição virou uma lista de palavras-chave

Reescreva em linguagem natural, descrevendo o conteúdo pertinente. O Google recomenda texto alternativo informativo e contextualizado e orienta evitar excesso de palavras-chave. A referência está nas boas práticas de SEO para imagens. Esse cuidado não assegura posição nos resultados de busca.

O texto está dentro de uma imagem

Se uma instrução essencial aparece somente em uma arte, disponibilize essa informação também como texto da página. Isso facilita leitura, seleção e revisão. Em páginas de contato, mantenha instruções e rótulos acessíveis no formulário. Veja também como escolher os campos de um formulário de orçamento.

Checklist antes de concluir

Confira a função da imagem, a precisão da descrição, a presença do atributo alt no elemento correto e a leitura da legenda. Teste a página no celular. Nas imagens reutilizadas, revise cada contexto. Registre a URL e o trecho corrigido para facilitar a próxima conferência.

Perguntas frequentes (FAQ)

Existe um número obrigatório de caracteres?

Use o espaço necessário para comunicar a informação com clareza. Uma fotografia simples costuma permitir uma frase curta. Um gráfico que exige vários parágrafos deve ter explicação no conteúdo, além de uma identificação concisa na imagem.

Preciso começar com “imagem de”?

Geralmente é possível começar pelo conteúdo representado. Quando o tipo de representação altera a interpretação, informe que se trata de ilustração, esquema ou fotografia, conforme o caso.

Posso usar o título do artigo em todas as imagens?

Revise o que cada imagem acrescenta. Repetir o título pode deixar sem descrição justamente o detalhe que diferencia uma fotografia da outra.

A legenda substitui o campo de texto alternativo?

Cada campo tem uma função na apresentação. Considere a informação já visível ao decidir o alt e confira o resultado no HTML para evitar descrições redundantes ou ausentes.

Esse ajuste exige uma assinatura de SEO?

O bloco Imagem oferece o campo nativamente. A edição manual descrita aqui não depende de uma assinatura de SEO. Outros construtores podem organizar seus controles de forma diferente.

DEVICENTE MKT

Quer transformar essa ideia em um projeto profissional?

Produção e edição de vídeos, marketing digital e sites. Conte o que sua empresa precisa e solicite uma proposta.

Solicitar orçamento ↗
☎ WhatsApp