Perguntas frequentes

O Smart Bulk Image Upload é um app da Shopify que envia imagens de produtos em massa a partir de uma pasta do Google Drive ou do Dropbox e vincula cada imagem automaticamente ao produto e à variante certos.

Em vez de arrastar imagens para os produtos uma por uma, você nomeia os arquivos com um identificador que seu catálogo já tem (um SKU, um código de barras, um título de produto, um valor de metacampo ou um ID de variante), escolhe a pasta e o app faz o resto. Ele também escreve um texto alt de SEO em cada imagem.

O app lê o nome do arquivo de cada imagem e o compara com um identificador das suas variantes: SKU, código de barras, título do produto, valor de metacampo ou ID da variante, o que você escolher. A associação não diferencia maiúsculas de minúsculas.

Assim, AB-1234.jpg vai para a variante cujo SKU é AB-1234. Os tipos de associação padrão são baseados em regras, então os resultados são previsíveis e repetíveis. Se os nomes dos seus arquivos forem inconsistentes, a associação com IA (beta) opcional os lê como uma pessoa leria, e você continua revisando cada associação antes de qualquer envio.

1. Instale o app pela Shopify App Store.
2. Em Configurações → Origem das imagens, escolha Google Drive ou Dropbox e conecte sua conta na página Criar envio.
3. Escolha a pasta com suas imagens e um tipo de associação e clique em Iniciar associação.
4. Revise a prévia (nada foi gravado na sua loja ainda) e clique em Iniciar envio.

Uma primeira execução com uma pasta de teste pequena leva alguns minutos. Recomendamos começar com 10 a 20 imagens.

Sim. Há um tutorial completo no YouTube, e o mesmo vídeo está na página de Suporte dentro do app.

Não. Suas imagens ficam no seu próprio Google Drive ou Dropbox. O app lê a pasta escolhida, baixa cada imagem associada e a envia para a Shopify. Nada no seu Drive ou Dropbox é renomeado, movido ou excluído.

Sim, com os dois. Você escolhe uma origem por loja nas Configurações e pode trocar quando quiser. Vale conhecer duas diferenças:

• Google Drive: só são listados os arquivos que o Drive reconhece como imagens, então documentos ou ZIPs perdidos são ignorados. A prévia mostra miniaturas e megapixels.
• Dropbox: todos os arquivos da pasta são listados, então mantenha a pasta limpa. O Dropbox não fornece miniaturas nem dados de megapixels.

Por padrão, só a pasta selecionada é lida. A leitura de subpastas pode ser ativada para a sua loja mediante pedido.

Nomeie cada arquivo com o identificador, seguido opcionalmente de um sublinhado e um número para a ordem da imagem: <identificador>_<ordem>.<extensão>.

Nome do arquivo	Associa com	Posição
AB-1234.jpg	ab-1234	1ª
AB-1234_1.jpg	ab-1234	2ª
AB-1234_2.png	ab-1234	3ª
7891234567890.jpg	7891234567890	1ª

Se a parte depois do último sublinhado for um número, ela indica a posição da imagem; caso contrário, continua fazendo parte do identificador. Maiúsculas e minúsculas não importam. Veja todas as regras no guia de nomes.

Os erros mais comuns são espaços no final, extensões ausentes e sufixos não numéricos:

• Espaços no final: AB-1234 .jpg não será associado, porque o espaço passa a fazer parte do identificador.
• Sem extensão: um arquivo sem extensão nunca pode ser associado.
• Sufixos não numéricos: AB-1234_a.jpg procura o identificador ab-1234_a, não ab-1234.
• Convenções misturadas: alguns arquivos usam _1 e outros -1 na mesma pasta.
• Nomes de arquivo duplicados dentro da mesma pasta.

Tudo isso aparece na lista de imagens não associadas da prévia antes de qualquer envio, então um erro custa uma renomeação, não uma limpeza.

Sim. Adicione um sufixo numérico e o app mantém as imagens nessa ordem: AB-1234_0.jpg → 1ª, AB-1234_1.jpg → 2ª, AB-1234_2.jpg → 3ª.

Só a ordem relativa importa, então _1, _3, _7 dá o mesmo resultado que _1, _2, _3. Um arquivo sem sufixo conta como primeira posição, por isso não use AB-1234.jpg e AB-1234_0.jpg para o mesmo produto.

Você tem quatro boas opções:

• Associar por outro campo: código de barras, título do produto ou ID da variante podem combinar melhor que o SKU.
• Usar um metacampo: coloque seu código de imagem (muitas vezes um código de ERP ou de fornecedor) em um metacampo de produto ou variante e associe por ele.
• Usar uma opção "contém": se os nomes têm o SKU e mais texto, como nikon-d750-AB1234-front.jpg, escolha "Associar se a imagem contém o SKU".
• Usar a associação com IA (beta): para nomes com separadores diferentes, palavras extras ou nomes de cores.

Também podemos aplicar regras de limpeza aos identificadores da sua loja antes da associação, por exemplo para ignorar tudo o que vem depois do primeiro hífen de um SKU.

Você pode associar por SKU, código de barras, título do produto, um metacampo ou o ID da variante:

• SKU: o padrão e a escolha mais segura.
• Código de barras (EAN/UPC/GTIN): muito confiável, porque códigos de barras costumam ser únicos e estáveis.
• Título do produto: para catálogos sem SKUs nem códigos de barras.
• Metacampo: qualquer metacampo de produto ou variante que você indicar.
• ID da variante: o ID numérico da Shopify. Totalmente inequívoco, ideal para correções.

Elas definem o quanto o nome do arquivo precisa corresponder ao identificador:

Opção	Associa quando	Use quando
Exato	O nome do arquivo é igual ao identificador	Os arquivos têm exatamente o nome do SKU ou do código de barras
A imagem contém o identificador	O identificador aparece dentro do nome do arquivo	Os nomes têm texto extra: photo-AB1234-front.jpg
O identificador contém o nome da imagem	O nome do arquivo aparece dentro do identificador	Uma foto vale para várias variantes: AB1234.jpg → AB1234-S, AB1234-M, AB1234-L

Com "a imagem contém o identificador", vence a correspondência mais longa, então um SKU curto não pode roubar a imagem de um mais longo. Com "o identificador contém o nome da imagem", vencem todas as correspondências, então confira a contagem na prévia antes de enviar.

A associação com IA (beta) é um tipo de associação opcional que lê cada nome de arquivo como uma pessoa leria, então separadores diferentes, palavras extras, nomes de cores ou números de imagem não impedem uma correspondência.

Você continua escolhendo o campo (SKU, código de barras, título ou metacampo), e cada associação com IA aparece na prévia com seu nível de confiança para você revisar antes do envio. Lojas no plano gratuito podem avaliar até 1.000 imagens por dia com IA; os planos pagos não têm limite.

Sim. As opções "o identificador contém o nome da imagem" foram feitas para isso: uma foto com o código base é vinculada a cada tamanho ou cor que estende esse código.

Se várias variantes compartilham o mesmo identificador (o mesmo SKU ou o mesmo título de produto), o app mantém só a primeira por padrão, para evitar duplicatas inesperadas. Podemos ativar a associação com várias variantes e vários produtos para a sua loja mediante pedido.

As causas mais comuns, em ordem de probabilidade, são identificadores duplicados, identificadores vazios, erros de nome e dados desatualizados:

1. Identificadores duplicados: duas variantes compartilham um SKU ou título. Por padrão, só a primeira fica com a imagem.
2. Identificador vazio: variantes sem SKU (ou sem código de barras ou valor de metacampo) são ignoradas.
3. Um erro de nome: um espaço no final, uma extensão ausente, um erro de digitação.
4. Dados desatualizados: você editou produtos depois da associação. Clique em Limpar cache na prévia e associe de novo.

Cada imagem não associada aparece na prévia com o identificador que o app procurou, e você pode exportar a lista em CSV.

Por padrão, produtos ativos, em rascunho e arquivados são incluídos. Podemos excluir os produtos arquivados para a sua loja e também limitar a associação a uma coleção ou um fornecedor específico.

Sim. A associação é totalmente somente leitura: o app mostra uma prévia de cada associação (miniatura, nome do arquivo, posição, a variante de destino, o identificador encontrado e o texto alt exato) e uma lista de todas as imagens que não corresponderam a nada.

Nada é gravado na sua loja até você clicar em Iniciar envio, então você pode associar quantas vezes quiser enquanto ajusta os nomes.

Sim. Na prévia, você pode:

• Desassociar: remover qualquer associação com um clique.
• Associar manualmente: escolher um produto para uma imagem não associada.
• Editar a variante: abrir o produto pela prévia; o app associa de novo automaticamente depois.
• Exportar: baixar em CSV a lista completa de imagens não associadas.

Cada imagem associada é enviada para a galeria de mídia do produto, e a primeira imagem de cada variante também é definida como a imagem dessa variante.

• As demais imagens ficam na galeria do produto.
• Produtos com apenas uma variante padrão recebem a imagem no nível do produto.
• Se preferir uma galeria única sem imagens de variante, ative Não vincular imagens às variantes nas Configurações.

Sim, em cada imagem enviada. Por padrão, o texto alt é o título da variante, ou seja, o título do produto mais os valores das opções (por exemplo Camiseta básica / Azul / M), ou apenas o título do produto em produtos com uma única variante. Você vê o valor exato na prévia antes do envio.

Outros formatos podem ser configurados para a sua loja (só o valor da opção, metacampo mais título, um sufixo personalizado, substituição de caracteres).

Você escolhe a cada envio:

• Não substituir imagens existentes (recomendado para testes): as novas imagens são adicionadas depois das que o produto já tem. Nada existente é alterado.
• Substituir imagens existentes: antes de enviar a primeira imagem nova de um produto, todas as imagens existentes desse produto são removidas. Produtos sem correspondência não são alterados.

No modo de substituição, você também pode ativar Não excluir imagens substituídas de 'Arquivos', que desvincula as imagens antigas mas mantém os arquivos em Conteúdo → Arquivos.

Sem o modo de substituição, processar a mesma pasta de novo adiciona imagens duplicadas. Use o modo de substituição, ou desassocie o que não precisar, ao repetir uma pasta.

As novas tentativas automáticas são diferentes: se um trabalho termina com erros, o app tenta de novo só as imagens que falharam e nunca reenvia uma imagem que já deu certo.

Sim. A página do trabalho mostra a porcentagem de progresso ao vivo, contadores de enviadas/total e um registro por imagem com link para cada variante e um motivo claro para qualquer falha. Você recebe o mesmo registro por e-mail quando o trabalho termina.

Você pode fechar o navegador: os trabalhos rodam em segundo plano e retomam de onde pararam após uma reinicialização.

São aceitos JPG, JPEG, PNG, WEBP e GIF. Para melhores resultados, use JPG ou WEBP, de 2048 a 4096 px no lado maior, sRGB e menos de 5 MB. A Shopify recodifica as imagens e entrega tamanhos responsivos de qualquer forma.

A Shopify limita as imagens de produto a 20 MB e 20 megapixels; o app redimensiona e recodifica automaticamente os arquivos maiores e só informa um erro se a imagem ainda não couber. Arquivos acima do limite são sinalizados na prévia antes do envio.

A Shopify também permite no máximo 250 imagens por produto.

Dezenas de milhares de imagens por processo. O app foi feito para catálogos grandes: carrega todo o seu catálogo em uma única operação em massa, baixa e envia em paralelo e retoma após uma reinicialização. Lojistas já o usaram para migrar catálogos de 40.000 a 60.000 SKUs.

A Shopify limita a velocidade com que os arquivos de uma loja podem mudar, então um lote muito grande avança de forma constante ao longo de horas, não minutos. O app reduz o ritmo e tenta de novo automaticamente, então você não precisa ficar acompanhando.

Os resultados da associação são válidos por duas horas. Depois disso, clique em Associar de novo antes de enviar. Use Associar de novo depois de renomear arquivos e Limpar cache depois de editar SKUs, códigos de barras, títulos ou metacampos na Shopify.

O app é gratuito para até 25 imagens; os envios ilimitados custam US$ 69, US$ 99 ou US$ 149 por mês, conforme o seu plano da Shopify.

Plano	Preço	Envios
Free	US$ 0	25 imagens no total
Premium (Shopify Basic, Grow e inferiores)	US$ 69 / mês	Ilimitados
Premium PRO (Shopify Advanced)	US$ 99 / mês	Ilimitados
Enterprise (Shopify Plus)	US$ 149 / mês	Ilimitados

A cobrança é feita pela Shopify, então o valor aparece na sua fatura normal da Shopify.

O plano gratuito inclui todos os recursos, com um limite total de 25 imagens enviadas (não por trabalho). A associação é ilimitada e gratuita, então você pode testar seus nomes com todo o catálogo antes de pagar. Ao atingir o limite, o trabalho para com a mensagem "Free upload limit reached".

Mude para um plano inferior dentro do app ou desinstale-o. Nos dois casos, a assinatura é cancelada automaticamente. As imagens que você já enviou continuam na sua loja exatamente como estão.

Os planos pagos acompanham o seu plano da Shopify para que lojas menores paguem menos pelos mesmos envios ilimitados. Todos os planos pagos incluem os mesmos recursos: envios ilimitados, orientação na configuração, prioridade na fila de envio e associação sob medida para a sua loja.

O app precisa de acesso de leitura e gravação aos seus produtos e de gravação aos arquivos na Shopify, além de acesso somente leitura ao Google Drive ou ao Dropbox.

Ele nunca grava, renomeia ou exclui nada no seu armazenamento em nuvem. Você pode desconectar a conta quando quiser, e desinstalar o app remove o acesso dele à sua loja.

Sim. Todos os dados trafegam por TLS 1.2+ e são criptografados em repouso. Os tokens do Google Drive e do Dropbox só são guardados enquanto a conexão existir. Desconecte ou desinstale e eles são revogados e excluídos na hora, junto com os dados da sua loja.

As imagens são baixadas apenas para serem repassadas diretamente à Shopify; não guardamos uma cópia da sua biblioteca de mídia. Seus dados nunca são compartilhados com terceiros, e o acesso ao Drive passou pela avaliação de segurança CASA do Google. Veja nossa Política de privacidade.

Sim. Podemos registrar um rastreamento completo de uma associação na sua loja e dizer exatamente quais identificadores foram indexados, quais colidiram e com o que cada imagem foi associada. Fale conosco informando o domínio da loja, o nome da pasta, o tipo de associação, quando você executou mais ou menos e dois ou três exemplos de nomes de arquivo.

Muitas vezes, sim. Entre as opções que podemos ativar por loja estão: leitura de subpastas, associação com várias variantes e vários produtos, uma imagem em várias variantes, substituir só as imagens da variante associada, excluir produtos arquivados, filtros por coleção ou fornecedor, regras de limpeza de identificadores, formatos de texto alt e normalização Unicode para títulos com acentos.

Se o seu catálogo tem alguma particularidade que não está nessa lista, conte para a gente. A maioria dessas opções nasceu do pedido de um lojista.

Use o chat ao vivo na página de Suporte dentro do app ou escreva para hello@craftshift.com. Nossa equipe fica na Europa e responde a todas as mensagens.