Blog

A maioria dos sites WordPress publica imagens sem alt text. A Criamente criou um plugin gratuito e resolveu isso.

A Criamente desenvolveu um plugin WordPress com integração à API Gemini que gera alt text em português nos três momentos do fluxo editorial.

Escrito por

Eric Saboya

Eric Saboya
CEO + AI Search + UX Design

Um olho branco estilizado com íris roxa projeta raios coloridos de visão sobre um botão com o texto `<alt>`, em um fundo gradiente roxo.

Alt text ausente é um dos erros mais frequentes em bibliotecas de mídia WordPress, e também um dos mais silenciosos. A Criamente desenvolveu um plugin próprio com integração à API Gemini que gera descrições de imagem diretamente no painel, eliminando o campo vazio que penaliza acessibilidade e findability ao mesmo tempo.

O alt text nunca foi uma formalidade de checklist

Ele existe para dois públicos simultâneos: pessoas que dependem de leitores de tela e mecanismos de busca que interpretam imagens para indexação. Omitir esse campo não é uma lacuna de acessibilidade isolada. É uma instrução de silêncio enviada ao Google sobre parte significativa do conteúdo visual do site.

O relatório WebAIM Million 2024 identificou que 54,5% das páginas auditadas apresentavam imagens com texto alternativo inadequado ou ausente. No contexto de busca multimodal, onde modelos de linguagem interpretam imagens em conjunto com texto, esse índice representa visibilidade sistematicamente perdida.

O problema real é de escala editorial, não de intenção

Dentro desse contexto, a raiz do problema não é descuido. É volume.

Equipes com centenas de imagens em biblioteca não têm capacidade editorial para descrever cada arquivo de forma estratégica. O resultado são campos vazios, nomes de arquivo copiados como alt text ou descrições genéricas que nada informam ao algoritmo.

Esse gargalo é estrutural. E problemas estruturais pedem solução de processo, não mais esforço manual por imagem.

Como a Criamente construiu a solução internamente

A Criamente enfrentou essa mesma limitação na gestão das próprias bibliotecas de mídia e optou por desenvolver um plugin WordPress proprietário com integração à API Gemini.

O plugin analisa o conteúdo visual de cada imagem e retorna uma descrição em português, com 15 a 25 palavras e ponto final, pronta para uso editorial. Algumas decisões técnicas garantem estabilidade e eficiência no uso:

  • Detecção dinâmica do modelo Gemini ativo, com cache de seis horas, evitando que atualizações de API quebrem o funcionamento
  • Redimensionamento automático das imagens para 800px antes do envio, reduzindo consumo de tokens sem perda de qualidade descritiva
  • Output configurado para português, com tom descritivo e extensão calibrada para SEO
  • Integração nativa à biblioteca de mídia do WordPress, sem dependência de plugins de terceiros

O plugin resolve o problema em três momentos do fluxo editorial

Equipes com acervos históricos, rotinas de publicação ativas e inserções pontuais têm necessidades diferentes. O plugin foi estruturado para cobrir os três, sem exigir que o editor adapte o próprio fluxo de trabalho.

  • Geração individual: o editor seleciona uma imagem específica e aciona a geração com revisão pontual
  • Geração em lote: painel de progresso em tempo real processa múltiplos arquivos em sequência, sem intervenção manual a cada item
  • Geração automática no Gutenberg: toda imagem inserida já recebe alt text gerado automaticamente, sem nenhuma ação manual do editor

A terceira camada fecha o ciclo: geração automática no momento em que a imagem é inserida no Gutenberg. Toda imagem adicionada já entra com alt text gerado, disponível para revisão antes da publicação. Nenhum campo em branco acumulado.

Como o plugin se posiciona em relação a outras soluções disponíveis

Esse conceito ganha clareza quando comparado com as principais alternativas do mercado:

Plugin CriamenteAltText.aiImage Attributes Pro
CustoGratuitoPago (trial: 25 imagens)Gratuito / Pro pago
Tipo de geraçãoIA com visão computacionalIA com visão computacionalRegras: nome de arquivo ou título de página
Idioma nativoPortuguês130+ idiomasDepende do nome do arquivo
Geração individualSimSimSim
Geração em loteSim, com painel de progressoSimSim
Auto no uploadSimSimSim
Controle do promptTotalLimitadoNenhum
Dependência externaAPI Gemini (Google)Servidor AltText.aiNenhuma

A diferença central entre o plugin da Criamente e o Image Attributes Pro está na natureza da geração. O Image Attributes Pro deriva o alt text de metadados textuais, como o nome do arquivo ou o título da página. Não há análise visual real da imagem. O plugin da Criamente e o AltText.ai, ao contrário, enviam a imagem para um modelo de visão computacional e descrevem o que está visualmente presente. A diferença é relevante para casos onde o conteúdo da imagem não está refletido no nome do arquivo ou no título da página, o que é a regra, não a exceção.

A IA gera a base descritiva. A curadoria editorial define o posicionamento.

Essa distinção ganha peso quando se observa o que a automação entrega e o que ela não substitui.

A IA descreve o que está visível. O contexto de marca, o posicionamento estratégico do produto e a escolha de termos relevantes para SEO são decisões editoriais.

Uma imagem de embalagem pode ser descrita como "frasco de vidro com tampa escura". O alt text correto para a marca pode ser "frasco da linha premium X, voltada para cosméticos de alta performance". A diferença entre as duas descrições é de posicionamento, não de visão computacional. O plugin elimina o trabalho de partir do zero, que é onde o tempo editorial se perde.

O plugin está disponível para download gratuito. A instalação segue o fluxo padrão do WordPress: basta enviar o arquivo .zip pelo painel de administração e configurar a chave da API Gemini nas configurações do plugin. O download está disponível em criamente.com/plugin-wordpress/ai-alt-generator.zip.

Vamos Conversar?

Ficou alguma dúvida?

Perguntas e Respostas

Veja abaixo perguntas comuns a respeito do conteúdo abordado

  • O plugin está disponível para qualquer site WordPress?
    • Sim. O plugin é gratuito e pode ser baixado diretamente pelo site da Criamente. A instalação segue o fluxo padrão do WordPress: upload do arquivo .zip pelo painel de administração e configuração da chave da API Gemini nas configurações do plugin. O custo de uso é determinado exclusivamente pelo volume de chamadas à API Gemini, sem mensalidade ou licença.
  • Qual é o custo de usar a API Gemini para gerar alt text?
    • O custo é determinado pelo volume de chamadas à API. A Criamente opera com limite de orçamento configurado no Google Cloud, o que elimina cobranças inesperadas. Para volumes editoriais típicos, o custo é zero, e em casos de enormes quantidades de gerações, marginal.
  • Por que a geração por IA é mais precisa do que derivar o alt text do nome do arquivo?
    • Ferramentas como o Image Attributes Pro constroem o alt text a partir de metadados textuais: nome do arquivo, título da página ou foco de keyword do plugin de SEO. Nenhuma análise visual acontece. Um modelo de visão computacional descreve o que está presente na imagem, independentemente do que o arquivo foi nomeado. Para acervos com imagens genéricas ou mal nomeadas, a diferença de qualidade é significativa.
  • A geração automática no Gutenberg funciona com qualquer tipo de imagem?
    • Sim. Toda imagem inserida no editor aciona a geração automaticamente. O plugin redimensiona o arquivo para 800px antes do envio à API, reduzindo consumo de tokens sem perda de qualidade descritiva.
  • O alt text gerado pela IA precisa de revisão antes de publicar?
    • Revisão editorial é recomendada. A IA descreve o conteúdo visual com precisão, mas o alinhamento ao contexto de marca, às palavras-chave estratégicas e ao tom do conteúdo é uma decisão humana, não um output automatizável.