Importar um CSV Shopify sem partir o catálogo

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.

A estrutura de um CSV nativo do Shopify

Exporte um produto a partir do seu admin Shopify (Products → Export) para ver a estrutura oficial. As colunas principais:

Coluna	Função	Editável em bulk?
`Handle`	Identificador único (= slug do URL)	⚠️ Nunca
`Title`	Nome do produto	✅ Sim
`Body (HTML)`	Descrição	✅ Sim
`Vendor`	Marca/fornecedor	✅ Sim
`Type`	Tipo de produto	✅ Sim
`Tags`	Tags (separadas por vírgula)	✅ Sim, com cuidado
`Published`	Publicado sim/não (`TRUE`/`FALSE`)	✅ Sim
`Option1 Name`, `Option1 Value`	Nome + valor da primeira variante	⚠️ Nunca
`Option2 Name`, `Option2 Value`	Segunda variante	⚠️ Nunca
`Option3 Name`, `Option3 Value`	Terceira variante	⚠️ Nunca
`Variant SKU`	Código SKU da variante	⚠️ Nunca
`Variant Price`	Preço da variante	✅ Sim
`Variant Compare At Price`	Preço riscado (preço anterior)	✅ Sim
`Variant Inventory Qty`	Quantidade em stock	✅ Sim
`Image Src`	URL da imagem	✅ Sim
`Image Alt Text`	Alt text da imagem	✅ Sim
`SEO Title`	Título SEO	✅ Sim
`SEO Description`	Meta description	✅ Sim
`Status`	`active`/`archived`/`draft`	✅ Sim, com cuidado

Cada linha = um SKU, não um produto. Um produto com 3 variantes = 3 linhas que partilham o mesmo Handle.

As 6 colunas que nunca deve alterar em massa

Estas colunas são as chaves de integridade do seu catálogo. Alterá-las sem cuidado parte o conjunto:

`Handle`

O handle gera o URL público do produto. Alterar um handle:

Altera o URL do produto (/products/chaussure-derby → /products/chaussure-derby-v2)
Parte todos os backlinks externos
Parte os links internos (emails transaccionais, menus, anúncios Google Shopping)
Faz perder o ranking SEO acumulado

Regra: nunca altere um Handle existente. Apenas na criação de novos produtos.

`Variant SKU`

O SKU é a chave de identificação das variantes no seu stock, no seu WMS e nas suas ferramentas analíticas. Alterá-lo:

Desregula o inventário se usar um sistema externo (ERP, WMS)
Parte integrações (fulfillment providers, fornecedores de dropshipping)
Pode criar variantes duplicadas se o Shopify deixar de reconhecer o original

Regra: edite os SKU apenas produto a produto, nunca em bulk CSV.

`Option1 Name`, `Option2 Name`, `Option3 Name`

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.

Preparar o CSV: os 5 checks antes do upload

Antes de qualquer importação, verifique:

Check 1 — Codificação UTF-8

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).

Gerir variantes sem duplicar

Um produto com 3 variantes descreve-se em 3 linhas CSV:

Handle,Title,Option1 Name,Option1 Value,Variant SKU,Variant Price
derby-cuir,Derby Cuir,Taille,42,DERBY-BLK-42,149.00
derby-cuir,,,,,
derby-cuir,,,,,

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.

Imagens: Drive vs CDN vs Shopify Files

Três opções para os URLs das imagens:

Opção 1 — Google Drive

❌ Não funciona para o Shopify. O Drive devolve uma página HTML, não uma imagem directa. O Shopify falha em silêncio.

Opção 2 — CDN público (Cloudflare Images, Amazon S3 + CloudFront, Bunny CDN)

✅ Recomendado para importações grandes. As imagens são alojadas fora do Shopify e depois o Shopify descarrega-as no momento da importação.

Custo típico: 1-5 € por mês para 1000 imagens num CDN.

Opção 3 — Shopify Files

✅ Upload manual das imagens em Content → Files no Shopify e depois uso dos URLs do Shopify no CSV. Adequado para catálogos pequenos (<500 imagens).

Limite: o upload no Shopify Files é manual, não é scriptável para 10 000 imagens.

Recomendação: CDN público para a importação inicial; depois o Shopify aloja as imagens automaticamente após a importação.

Rollback antes da publicação

O Shopify não propõe rollback nativo para uma importação CSV que correu mal. Mas pode preparar um rollback antes:

Etapa 1 — Exportar antes da importação

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).

Etapa 2 — Importar com publicação em modo draft

Altere o seu CSV para que Published = FALSE ou Status = draft em todos os produtos importados. Os produtos são criados, mas ficam invisíveis na loja.

Etapa 3 — Verificação manual

No admin, percorra 20 produtos aleatórios importados. Verifique:

Imagens carregadas correctamente
Variantes ok
Preço correcto
Descrição limpa

Etapa 4 — Publicação por batch

Se tudo estiver correcto, publique. Se detectar um problema, basta apagar os produtos em draft, reimportar o CSV de backup e recomeçar.

Em caso de estrago grande

Se a importação tiver sobrescrito o seu catálogo activo sem passar por draft:

Importe imediatamente o seu CSV de backup — vai reescrever o estado actual
Os URLs e as reviews são preservados (o Shopify identifica-os por Handle)
Conte com 1-2h para o Google voltar a fazer crawl e a reclassificar

Alternativas ao CSV nativo: quando passar para uma ferramenta especializada

O CSV nativo é potente, mas pesado. Para operações regulares em >1000 produtos:

Matrixify (antigo Excelify): o mais completo, gere relações complexas, ~20 $/mês
Shopify Flow: automatização interna do Shopify, ideal para triggers (stock baixo, tag, etc.)
Ecomptimize: otimiza descrições, metas e SEO em todo o catálogo; o ficheiro de origem permanece descarregável durante 30 dias para reimportar em caso de problema

Para reescrever descrições em massa com controlo de qualidade, a ferramenta dedicada supera claramente o CSV. Veja Ecomptimize para Shopify.

Importar um CSV Shopify sem partir o catálogo