Importar produtos em massa para Shopify: guia de CSV e Matrixify

Para importar produtos em massa para Shopify, você usa um arquivo CSV que segue a estrutura oficial da Shopify, ou uma ferramenta especializada como o Matrixify quando o catálogo cresce ou os dados ficam complexos. O sucesso depende menos da ferramenta de importação e mais do que vem antes dela: limpar os dados, encaixar as opções no limite de três, preparar URLs públicas de imagens, e então importar tudo como rascunho e revisar uma amostra antes de publicar. Este guia resume o que aprendemos importando catálogos de até dezenas de milhares de produtos.

Como a Shopify lê um arquivo CSV

A ideia mais importante a entender antes de abrir qualquer planilha: em um arquivo da Shopify, um produto ocupa várias linhas. A primeira linha carrega os dados do produto (título, descrição, fornecedor, tipo, tags) junto com a primeira variante e sua primeira imagem. Cada variante adicional é uma nova linha com o mesmo handle e seus valores de opção, preço e quantidade, e cada imagem adicional é uma linha apenas com o handle, a URL da imagem e a posição.

O handle é a chave: texto latino em minúsculas com hífens (como oud-arabe-50ml) que identifica o produto e se torna parte da URL em /products/handle. Linhas que compartilham um handle são combinadas em um único produto.

As colunas principais de um arquivo Shopify

Coluna	Conteúdo	Observação
Handle	Identificador do produto na URL	O mesmo em todas as linhas do produto
Title	Nome do produto	Apenas na primeira linha
Body (HTML)	Descrição	Aceita HTML simples
Vendor	Marca	Unifique a grafia (Samsung, não samsung)
Product Category / Type	Categoria Shopify e tipo de produto	Ajuda o Merchant Center e os impostos
Tags	Tags separadas por vírgula	A base das coleções automáticas e dos filtros
Published / Status	Publicado ou rascunho	Comece com rascunho
Option1/2/3 Name e Value	Opções e seus valores	Três opções no máximo
Variant SKU / Barcode	Código do produto e código de barras	O código de barras importa para anúncios
Variant Price / Compare At Price	Preço e preço antes do desconto	Sem símbolos de moeda
Variant Inventory Qty / Tracker	Quantidade e rastreamento de estoque	Precisa de um local de estoque
Variant Grams	Peso	Para o cálculo de envio
Image Src / Position / Alt Text	URL da imagem, ordem e texto alternativo	Apenas URLs públicas
SEO Title / SEO Description	Título e descrição para buscadores	Transfira da loja antiga

A documentação da Shopify oferece um arquivo de exemplo; o começo mais fácil é exportar um produto da sua loja e preencher a planilha nesse padrão.

Opções e variantes: o limite de três opções

A Shopify permite três opções por produto (como cor, tamanho e material). Um produto vindo do Magento ou do WooCommerce com quatro ou mais atributos precisa de uma decisão antes da importação:

• Unir duas opções em uma (como “Vermelho / Algodão”) quando as combinações são poucas.
• Mover o atributo que não afeta preço nem estoque para um metafield ou tag (como país de origem).
• Dividir o produto em dois se o quarto atributo realmente muda o produto.

Uma regra prática: opção é tudo o que muda preço, quantidade ou imagem; o restante é informação para exibir, não escolha a fazer.

Imagens: a falha de importação mais comum

As URLs de imagem nos arquivos de exportação normalmente apontam para a hospedagem da loja antiga. Se essa hospedagem for desligada antes de a importação terminar, os produtos ficam sem imagens. O que fazemos: confirmar que as URLs são públicas e funcionam sem login, manter a hospedagem antiga viva até que importação e revisão terminem, colocar a imagem principal na Posição 1, e escrever texto alternativo descrevendo o produto em árabe ou inglês, porque a busca de imagens traz tráfego real.

Metafields: o que as colunas principais não comportam

Informações como ingredientes, país de origem, tabelas de tamanho, prazo de garantia ou especificações técnicas vivem em metafields e são exibidas pelo tema ou usadas em filtros. A Shopify suporta colunas de metafields no CSV depois que elas são definidas nas configurações da loja, e o Matrixify as suporta com mais flexibilidade. Defina os metafields antes da importação, não depois, ou você precisará de uma segunda rodada de importação.

Importador nativo ou Matrixify?

Situação	Melhor ferramenta
Centenas de produtos com estrutura simples	Importador nativo no painel da Shopify
Milhares de produtos ou arquivos acima do limite de tamanho	Matrixify (ou dividir em lotes)
Atualizar apenas colunas específicas (preços, quantidades)	Atualização parcial do Matrixify
Importar pedidos, clientes e redirecionamentos com os produtos	Matrixify
Importação recorrente agendada a partir de uma URL de arquivo	Matrixify
Muitos metafields complexos	Matrixify

O Matrixify (antigo Excelify) é um app da Shopify App Store que importa e exporta produtos, clientes, pedidos e redirecionamentos de arquivos Excel ou CSV e gera um relatório de resultado para cada linha. Em projetos grandes de migração é a nossa ferramenta principal; lojas pequenas não precisam dele.

Limpar os dados antes da importação

Uma hora de limpeza antes da importação economiza um dia de correções depois. Nossa lista fixa:

1. Unificar fornecedores e tipos: uma grafia por marca, e tipos de uma lista definida.
2. Títulos: uma estrutura consistente (marca + produto + tamanho ou variante), sem caixa alta, sem símbolos.
3. Descrições: remover HTML quebrado e estilos herdados do editor antigo.
4. Preços: apenas números, com preço comparativo maior que o preço ou vazio.
5. Códigos de barras e SKUs: únicos por variante, porque duplicatas fazem a linha falhar e confundem o Merchant Center.
6. Produtos mortos: tudo o que não é vendido há muito tempo e sem plano de retorno não é importado.
7. Tags: uma lista intencional de tags que serve às coleções automáticas, não tudo o que você herdou.

Como fazer isso em um catálogo existente está coberto no guia de limpeza de dados de produtos Shopify.

Passos para uma importação segura

1. Exporte um produto da Shopify para obter o modelo.
2. Preencha apenas 10 produtos e importe-os, depois revise no painel e na vitrine.
3. Corrija o modelo com base na amostra, depois importe o catálogo completo com status de rascunho.
4. Revise uma amostra aleatória de 50 produtos: imagens, opções, preços, quantidades, descrições.
5. Publique em lotes por coleção e acompanhe as coleções automáticas e os filtros.
6. Guarde o arquivo final de importação como referência junto com o relatório de resultado.

Depois de publicar vêm os preços e as promoções: nosso app SalePilot (salepilot.esafqa.com) edita preços e preços comparativos em massa por coleção, tag ou SKU com pré-visualização de cada alteração no nível da variante antes de publicar, e restaura os preços automaticamente quando a promoção termina, para que você nunca precise reimportar um arquivo a cada promoção.

Da nossa experiência

Para a Toolmart, mais de 35.000 produtos de 65 fornecedores migraram do Magento 2 para Shopify, e unificar fornecedores, tipos e códigos de barras foi o que fez as coleções automáticas e os anúncios de catálogo funcionarem depois. Para a Sophie’s, mais de 4.000 produtos chegaram do Odoo com dados incompletos, então o esforço foi cadastrar e enriquecer descrições e imagens antes da importação, e a loja terminou com 4.286 produtos publicados. Para lojistas cujo estoque de fornecedor muda diariamente, construímos um motor de sincronização para a BrandVIP que casa 8.788 produtos automaticamente, tema de sincronizar estoque de fornecedor com Shopify. Uma importação bem-sucedida faz parte de um plano maior descrito em migrar Magento para Shopify, e se você está começando uma loja nova, comece por criar uma loja Shopify passo a passo.

Conclusão

Importar produtos em massa para Shopify funciona quando você entende a estrutura do arquivo (várias linhas por produto), respeita o limite de três opções, prepara URLs públicas de imagens e metafields predefinidos, limpa os dados antes do envio, e então importa como rascunho e revisa uma amostra antes de publicar. Para catálogos grandes e atualizações parciais, o Matrixify é a ferramenta. Tudo isso faz parte do serviço de migração para Shopify da E-SAFQA.

Mande seu arquivo de produtos ou o link da loja no WhatsApp e diremos o que o seu catálogo precisa antes da importação.