Texto alternativo na Shopify: como escrever e corrigir em massa

Publicado em 17 de outubro de 2026

Também disponível em: English · Deutsch · Français · Español · Italiano · Nederlands · 日本語

Última verificação na Central de Ajuda da Shopify: 17 de outubro de 2026.

A maioria dos catálogos da Shopify tem centenas de imagens de produtos sem texto alternativo. É um campo fácil de pular: compradores que conseguem ver a imagem nunca percebem que ele está faltando. Este guia explica para que serve o texto alternativo, como escrevê-lo para fotos de produtos e como preenchê-lo em todo o catálogo sem quebrar nada.

O que é texto alternativo e para que serve

A Shopify descreve o texto alternativo como um texto que "descreve uma mídia e é uma parte importante da descrição do produto". Ele é exibido quando uma imagem não carrega, e "também é usado por tecnologias assistivas para descrever uma imagem a um cliente com deficiência visual" (Ajuda da Shopify: Adicionar texto alternativo à mídia).

Quem usa:

Compradores que usam leitores de tela. Esse é o principal motivo. Sem texto alternativo, um leitor de tela só consegue anunciar que há uma imagem, ou ler o nome de um arquivo. As WCAG, o padrão de acessibilidade na web, exigem alternativas em texto para imagens com significado.
Google. O Google diz que o texto alternativo é "o atributo mais importante quando se trata de fornecer mais metadados para uma imagem" e que usa o texto alternativo "junto com algoritmos de visão computacional e o conteúdo da página" para entender as imagens (Google Search Central: SEO para imagens).
Canais de compras com IA: provavelmente menos do que disseram a você. A lista da Shopify de detalhes de produto que as plataformas de IA usam cita imagens, não o texto alternativo especificamente (Otimizar seus produtos para plataformas de IA), e os sinais de qualidade da listagem da seção Agentic avaliam a cobertura de imagens. Não encontramos nenhuma documentação da Shopify ou da OpenAI dizendo que o texto alternativo afeta a classificação no ChatGPT. Escreva texto alternativo para pessoas e para o Google. Qualquer benefício para IA é um bônus, não o motivo.

Como escrever texto alternativo para imagens de produtos

O conselho da Shopify: "Mantenha seu texto alternativo breve e descritivo." O máximo é de 512 caracteres, "mas o recomendado é 125 ou menos".

Um padrão que funciona para a maioria das fotos de produtos:

O que é + o detalhe que diferencia esta imagem

A imagem principal: o nome do produto em palavras simples, mais seu principal atributo visível (cor, material, estilo).
Imagens de variantes: diga qual variante aparece ("em verde-floresta").
Ângulos adicionais: diga o que esta vista mostra que as outras não mostram ("vista de trás mostrando o bolso com zíper").
Fotos de estilo de vida: descreva a cena só na medida em que isso ajuda ("usada com jeans em uma rua da cidade").

Exemplos:

Imagem	Fraco	Melhor
Foto principal	`IMG_4432.jpg`	`Camiseta gola careca de algodão orgânico em verde-floresta`
Segundo ângulo	`camiseta`	`Camiseta de algodão orgânico, vista de trás com logo estampado`
Foto de detalhe	`camiseta verde camiseta barata melhor camiseta camiseta orgânica`	`Close da gola canelada e da costura dupla da camiseta`
Imagem da tabela de medidas	`tabela de medidas`	Coloque a tabela de medidas como texto real na página. Se ela precisar continuar como imagem, o texto alternativo deve conter as medidas.
Divisor decorativo	`decoração`	Deixe vazio (apenas imagens do tema, veja abaixo)

Regras que valem em todos os casos:

Não comece com "Imagem de" ou "Foto de". Os leitores de tela já anunciam que se trata de uma imagem.
Não encha de palavras-chave. O próprio exemplo ruim do Google é uma lista de palavras-chave sobre cães, e ele alerta que o excesso de palavras-chave "resulta em uma experiência negativa para o usuário e pode fazer com que seu site seja visto como spam".
Não repita o mesmo texto em todas as imagens de um produto. Se cinco imagens disserem "bota Voyager", um usuário de leitor de tela não aprende nada com as imagens dois a cinco.
Imagens com texto: se as palavras também aparecem como texto real por perto, não é preciso repeti-las. Se não aparecem, coloque as palavras no texto alternativo (árvore de decisão de texto alternativo do W3C).
Imagens decorativas que não acrescentam nenhuma informação devem ter um atributo alt vazio. Fotos de produtos quase nunca são decorativas.

Método 1: uma imagem por vez

No computador (Ajuda da Shopify):

Acesse Produtos e abra o produto.
Clique na imagem para abrir a prévia da mídia.
Clique em Adicionar texto alternativo (Add alt text), digite o texto e clique em Salvar texto alternativo (Save alt text).

No app Shopify para dispositivos móveis, abra o produto, toque na imagem, toque em Informações (Information), insira o texto e salve. Isso basta para seus 20 produtos mais vendidos, que de qualquer forma merecem um texto escrito à mão.

Método 2: texto alternativo sugerido pela Shopify

O editor de mídia da Shopify "pode sugerir texto alternativo para imagens que ainda não têm". A Shopify diz que as sugestões "são geradas com IA para ajudar a descrever o conteúdo da sua imagem" (Ajuda da Shopify: Editor de mídia). Aceitar uma sugestão a salva no arquivo. Continua sendo uma imagem por vez, e descrições geradas por IA descrevem o que está visível, então confira se a sugestão cita o produto e a cor reais, e não "uma pessoa usando uma camisa verde".

Método 3: importação por CSV (em massa, gratuita)

O editor em massa da Shopify não abrange o texto alternativo de imagens, mas o CSV de produtos sim. A página de texto alternativo da Shopify diz: "Você também pode enviar texto alternativo em um arquivo CSV" (Ajuda da Shopify: Usar arquivos CSV).

Exporte seus produtos para CSV e guarde uma cópia intacta como backup.
Cada imagem fica em sua própria linha, com o URL na coluna de origem da imagem e o texto na coluna Image Alt Text. Preencha os campos vazios. Uma fórmula de planilha pode montar um primeiro rascunho a partir do título do produto e da variante ou posição, que você depois melhora à mão.
Importe com a opção Substituir produtos com identificadores correspondentes (Overwrite products with matching handles) marcada.

Tenha cuidado. A Shopify diz que, ao substituir, uma célula vazia e não obrigatória substitui o valor existente por um valor vazio. Não exclua colunas nem limpe células que você não está alterando. Como a Shopify baixa os URLs das imagens durante a importação e os envia de novo, teste primeiro em três a cinco produtos e confira se as imagens e a ordem delas estão corretas antes de importar o restante.

Método 4: apps e a API

Desenvolvedores podem definir o texto alternativo pela mutação 0 da Admin GraphQL API, que atualiza "descrições de acessibilidade de imagens e outras mídias".
Apps podem fazer o mesmo de dentro do seu admin. Aviso: nosso app, o Surfaced, encontra imagens de produtos sem texto alternativo e as preenche com seus próprios dados: o título do produto, mais o nome da variante quando a imagem pertence a uma variante, ou o número da vista para imagens extras. Ele nunca substitui texto alternativo que você escreveu. Você visualiza cada alteração antes, toda alteração fica registrada e pode ser desfeita. O plano gratuito inclui 25 correções por mês.

Um texto baseado em modelo como esse é consistente e preciso, mas é um ponto de partida. Para seus produtos mais vendidos, edite-o para descrever o que cada ângulo realmente mostra.

Não se esqueça das imagens do tema

As imagens de banner, apresentação de slides e coleções do seu tema são definidas separadamente no editor de temas (Ajuda da Shopify: Adicionar texto alternativo às imagens do tema). Banners principais com texto embutido na imagem são uma falha de acessibilidade comum. Coloque a mensagem no texto alternativo ou, melhor ainda, em texto real sobre a imagem.

Checklist

Toda imagem de produto tem texto alternativo com 125 caracteres ou menos
As imagens de variantes citam a variante (cor, estampa, material)
Nada de "imagem de", nada de listas de palavras-chave, nada de texto idêntico entre as imagens de um produto
Imagens que contêm texto importante (tabelas de medidas, rótulos de ingredientes) têm esse texto na página ou no texto alternativo
Os 20 produtos mais vendidos têm texto alternativo escrito à mão para cada ângulo
Os banners e as imagens da apresentação de slides do tema têm texto alternativo
Cada variante de cor ou estilo tem sua própria imagem (um assistente de IA não consegue mostrar "a verde" sem ela)

O texto alternativo é um dos vários campos de produto que vale a pena organizar ao mesmo tempo. A seguir: definir categorias de produto em massa (em inglês) e adicionar códigos de barras GTIN (em inglês). Use o verificador de prontidão para IA gratuito para checar o texto alternativo e o restante dos seus dados públicos de produtos.