O CSV do Shopify é ao mesmo tempo a melhor e a pior forma de gerir um catálogo. Melhor: é o formato nativo, oficial, que permite editar 10 000 produtos de uma só vez. Pior: um CSV mal estruturado pode duplicar, sobrescrever ou apagar o seu catálogo em 3 minutos sem pedido de confirmação.
Eis a estrutura exacta, as 6 colunas que nunca deve alterar em massa e o procedimento de rollback para recuperar depressa em caso de problema.
Os nomes das opções definem a estrutura das variantes. Alterá-los após a criação:
Invalida as variantes existentes (o produto com Option1 Name = Tamanho passa a Option1 Name = Size, o que cria novas opções)
Cria duplicados silenciosos
Pode fazer explodir o número de variantes (de 20 para 200 em poucos segundos)
Regra: os nomes das opções ficam definidos na criação do produto, ponto final. Se precisar de os alterar, faça-o pela interface de admin, produto a produto.
Abra o CSV num editor de texto (VS Code, Notepad++). Verifique se os acentos e caracteres especiais aparecem correctamente. Se vir chaîne em vez de chaîne, o CSV está em latin1 ou windows-1252. Tem de o reconverter para UTF-8.
O Excel guarda em latin1 por defeito — evite o Excel para editar um CSV destinado ao Shopify. Use LibreOffice Calc, Google Sheets ou VS Code.
Check 2 — Separador vírgula
O CSV do Shopify usa a vírgula como separador. Em locais francófonos, o Excel usa ponto e vírgula por defeito. Se vir os seus dados numa única coluna ao abrir, o separador está errado.
Check 3 — Escape de vírgulas nos campos
Se uma descrição contiver uma vírgula (muito frequente), o campo deve estar entre aspas:
Handle,Title,Body (HTML)
derby-cuir,"Chaussure Derby en cuir","Élégante, confortable, fabriquée en France"
Sem aspas, a vírgula em "Élégante, confortable" seria interpretada como um novo campo e deslocaria tudo.
Check 4 — Linhas duplicadas
Um handle que aparece 2 vezes no CSV = o Shopify vai tratar a segunda linha como uma variante, não como um novo produto. Pode criar surpresas.
No Google Sheets ou Excel, use Data → Remove duplicates para limpar.
Check 5 — Caracteres especiais nos URLs das imagens
Image Src deve ser um URL público, acessível sem auth. Teste 3-5 URLs aleatórios com curl -I https://cdn.example.com/image.jpg — retorno 200 obrigatório. Se tiver URLs com espaços ou caracteres especiais, faça URL-encode (%20 para espaço).
Linha 1: produto completo com Title e Option1 Name
Linhas 2-3: APENAS o Handle e os valores da variante (Option1 Value, SKU, Price, etc.). Não repetir Title, Body, Vendor, etc. — caso contrário o Shopify considera-os modificações e pode duplicar.
Esta é a sintaxe CSV nativa do Shopify. Surpreende ao início, mas é rigorosa.
Mesmo antes da importação, exporte o seu catálogo completo (Products → Export → CSV file for Excel, Numbers, or other spreadsheet programs). Guarde essa exportação com a data no nome (catalog-2026-04-23-antes-import.csv).
Sim. Exporte tudo, mantenha apenas as colunas Handle + Variant SKU + as colunas a alterar e apague as outras colunas do CSV. O Shopify fará o match por SKU e só tocará nas colunas presentes.
Tecnicamente é ilimitado; na prática, o Shopify recomenda <50 000 linhas por ficheiro. Acima disso, divida em vários ficheiros com um Handle único por produto.
Se o seu CSV contiver uma coluna Image Src com um URL diferente do existente, sim — o Shopify descarrega a nova imagem e substitui. Se não quiser alterar as imagens, apague as colunas Image Src e Image Alt Text do CSV.
Usando Published = FALSE/Status = draft e publicando por batch depois de validar. O catálogo activo não é afectado durante a importação. Não há downtime visível do lado do cliente.
O Shopify actualiza o produto existente (match por Handle). As colunas do CSV sobrescrevem os valores existentes. As colunas ausentes do CSV são preservadas.
Não, não através do CSV de produto. As reviews gerem-se via Shopify Product Reviews (export/import dedicado na app) ou através do seu provider de reviews (Yotpo, Judge.me).
Para gerir as suas importações Shopify com preview, rollback e revisão de qualidade por IA, veja Ecomptimize para Shopify.