Imagens de variantes não aparecem no Shopify: como resolver
Você configurou as variantes, subiu as imagens, vinculou tudo. Mas na loja, o cliente troca de cor e a galeria não muda. Ou as imagens aparecem no admin mas não na página do produto. Ou o swatch mostra a cor errada.
Esse é um dos problemas mais frustrantes para lojistas do Shopify. As causas variam, mas na maioria das vezes são configurações simples que passaram despercebidas. Neste artigo, vamos passar pelos motivos mais comuns e como resolver cada um.
Neste artigo
- 1. O App Embed não está ativado
- 2. Imagens não foram vinculadas às variantes
- 3. Cache do navegador
- 4. Tema não compatível
- 5. Conflito entre apps
- 6. Imagem nativa não configurada
- 7. Ordem das opções no produto
- Checklist de diagnóstico
- Perguntas frequentes
- Leitura complementar
1. O App Embed não está ativado
Essa é a causa número 1. Você instala o app, configura tudo no painel, mas esquece de ativar o App Embed no editor de temas. Sem essa etapa, o app não injeta o JavaScript e CSS na loja. As imagens ficam configuradas no backend mas não aparecem no frontend.
Para verificar: vá em Loja Online > Temas > Personalizar. No editor de temas, clique em “App embeds” (ícone de bloco no menu lateral). Procure o Rubik Variant Images e confirme que o toggle está ativado. Salve.
Se você trocou de tema recentemente, o App Embed pode ter sido desativado. Sempre verifique depois de trocar ou atualizar o tema.
2. Imagens não foram vinculadas às variantes
Subir imagens para o produto não é a mesma coisa que vincular às variantes. No painel do Rubik Variant Images, você precisa arrastar cada imagem para a variante correspondente. Se as imagens estão na lista mas não foram arrastadas, o app não sabe quais fotos pertencem a qual variante.
Abra o produto no painel do app. Verifique se cada variante tem imagens vinculadas. Se estiver em branco, arraste as fotos ou use o Auto-Assign com IA para atribuir automaticamente.
3. Cache do navegador
Depois de fazer alterações, o navegador pode estar mostrando a versão antiga da página. Isso é especialmente comum com o cache do Shopify CDN, que pode levar alguns minutos para atualizar.
Solução: abra a página do produto em uma janela anônima (Ctrl+Shift+N no Chrome). Se funciona na anônima mas não na janela normal, é cache. Limpe o cache do navegador ou espere alguns minutos.
4. Tema não compatível
O Rubik Variant Images funciona com temas Online Store 2.0 do Shopify. Se você está usando um tema antigo (vintage, não OS 2.0), o app pode não funcionar corretamente. Temas antigos não suportam App Embeds e metafields da mesma forma.
Para verificar: no admin do Shopify, vá em Temas > Personalizar. Se você vê a opção “App embeds” no editor, seu tema é OS 2.0. Se não vê, é um tema antigo e precisa ser atualizado.
5. Conflito entre apps
Se você tem dois apps que modificam a galeria de imagens ou os seletores de variantes, eles podem entrar em conflito. Um app tenta controlar a galeria enquanto o outro faz o mesmo. O resultado: nenhum dos dois funciona direito.
A solução é usar apenas um app para imagens de variantes. Se você migrou de outro app para o Rubik, desative ou desinstale o anterior. Verifique também se snippets de código antigos não ficaram no tema.
Veja nossa comparação de apps de imagens de variantes para entender as diferenças entre as opções disponíveis.
6. Imagem nativa não configurada
Mesmo usando um app de imagens de variantes, a imagem nativa do Shopify (uma por variante, configurada no admin) continua sendo importante. Ela é usada como fallback em algumas situações e aparece no Google Shopping e nos e-mails de confirmação de pedido.
Se a imagem nativa está errada ou ausente, o comportamento pode ser inesperado. Configure a imagem principal de cada variante no admin do Shopify, além das imagens no app.
7. Ordem das opções no produto
O Shopify trata opções na ordem em que foram criadas. Se a primeira opção é “Tamanho” e a segunda é “Cor”, o app pode filtrar pela opção errada. A maioria dos apps de imagens filtra pela primeira opção visual.
Verifique a ordem das opções no admin do produto. Para filtragem por cor, “Cor” deve ser a primeira opção. Você pode reordenar as opções no admin do Shopify sem perder dados.
Checklist de diagnóstico
Quando as imagens de variantes não aparecem, passe por esta lista:
- O App Embed está ativado no editor de temas?
- As imagens estão vinculadas às variantes no painel do app?
- Testou em janela anônima?
- O tema é Online Store 2.0?
- Existe outro app modificando a galeria?
- A imagem nativa do Shopify está configurada?
- “Cor” é a primeira opção do produto?
Se nenhum desses pontos resolve, use o verificador de configuração do Rubik para identificar o problema automaticamente.
Perguntas frequentes
Por que as imagens aparecem no admin mas não na loja?
O motivo mais comum é o App Embed desativado. Verifique no editor de temas se o Rubik Variant Images está ativado na seção “App embeds”. Também teste em janela anônima para descartar cache.
Troquei de tema e as imagens pararam de funcionar. O que houve?
Ao trocar de tema, o App Embed precisa ser ativado novamente no novo tema. Vá em Personalizar > App embeds e ative o Rubik. Os dados do app (metafields) permanecem intactos, só o embed precisa ser reativado.
Outro app de variantes estava instalado antes. Pode estar causando conflito?
Sim. Desinstale o app anterior e verifique se snippets de código dele ficaram no tema. Dois apps modificando a galeria ao mesmo tempo causam comportamento imprevisível.
As imagens funcionam no desktop mas não no celular. Por quê?
Pode ser um problema de cache mobile ou uma configuração de tema que renderiza a galeria de forma diferente no celular. Teste em janela anônima no mobile e verifique se o tema tem configurações separadas para mobile.
A galeria mostra as imagens certas mas os swatches estão errados.
Verifique a configuração de cores no painel do app. Os códigos hexadecimais podem estar trocados ou ausentes. Redefina as cores para cada valor de opção.
A imagem da variante aparece no Google Shopping mas não na loja.
O Google Shopping usa a imagem nativa vinculada no admin do Shopify. O Rubik usa metafields para a filtragem na loja. São dados independentes. Configure ambos para consistência.
Posso reverter para o comportamento padrão do Shopify?
Sim. Basta desativar o App Embed do Rubik no editor de temas. A galeria volta ao comportamento padrão do Shopify (todas as imagens visíveis, scroll até a variante selecionada).
Leitura complementar
