Importar um CSV WooCommerce sem instalar plugin

O WooCommerce inclui um importador CSV nativo desde a versão 3.1 (2017). A maioria dos tutoriais diz para instalar o WP All Import ou o WooCommerce Product CSV Import Suite. Raramente é necessário. O módulo nativo cobre 90 % dos casos, gratuito, sem plugin adicional.

Aqui o método, a estrutura CSV exata e as armadilhas específicas do WooCommerce (categorias hierárquicas, atributos vs variações).

O módulo nativo: onde e como

No seu admin WordPress: Products → All Products, no topo dois botões:

Import — importar um CSV
Export — exportar todos os produtos

Este módulo gere create + update por SKU ou id, suporta atributos, categorias, tags, processa variações, permite dry-run.

Não suportado nativamente: mapping complexo com transformações, importação de imagens via FTP, mapping condicional. Para estes casos avançados um plugin é necessário.

A estrutura CSV WooCommerce

Colunas principais:

Coluna	Função
`ID`	Vazio para criação, preenchido para update
`SKU`	Identificador único (para match)
`Name`	Nome do produto
`Type`	`simple`, `variable`, `variation`
`Description`	Descrição completa (HTML)
`Regular price`	Preço normal
`Stock quantity`	Quantidade em stock
`Categories`	Categorias separadas por vírgula
`Images`	URLs separadas por vírgula
`Attribute 1 name`, `Attribute 1 value(s)`	Primeiro atributo

Cada linha = um produto simples ou uma variação. Um produto variável descreve-se em 1 linha pai + N linhas filhas.

Categorias hierárquicas: a armadilha WooCommerce

O WooCommerce gere categorias em múltiplos níveis:

Vestuário
├── Homem
│   ├── Sapatos
│   └── Camisas
└── Mulher

Para atribuir um produto a "Vestuário > Homem > Sapatos":

Categories
"Vestuário > Homem > Sapatos"

Separador: > com espaços à volta. Se uma categoria não existe, o WooCommerce cria automaticamente.

Erro frequente: esquecer os espaços à volta do >. Sem espaços (Vestuário>Homem>Sapatos), o WooCommerce cria uma única categoria com esse nome literal.

Atributos vs variações

A confusão clássica.

Atributo global (Attribute 1 name = Tamanho, valores 42, 43, 44): uma característica mostrada na página do produto, utilizável para filtragem. Não cria variações.

Variação (linha com Type = variation, Parent = sku-do-pai): uma declinação comprável com preço próprio, stock, SKU.

Para tamanhos/cores, normalmente quer variações (permite rastrear stock por variante):

SKU,Type,Name,Parent,Attribute 1 name,Attribute 1 value(s),Regular price
DERBY-BLK,variable,Derby Couro,,,Tamanho,"42, 43, 44",
DERBY-BLK-42,variation,,DERBY-BLK,Tamanho,42,149.00
DERBY-BLK-43,variation,,DERBY-BLK,Tamanho,43,149.00

Update vs create: match por SKU

O WooCommerce faz match primeiro por ID, depois por SKU se ID estiver vazio.

Para criar novos produtos: deixe ID vazio, use SKUs únicos.

Para atualizar produtos existentes: preencha ID ou SKUs existentes. Marque "Update existing products" na importação.

Imagens: URLs externas ou upload prévio

URLs externas (recomendado para grandes imports): o CSV contém URLs públicas de um CDN. O WooCommerce descarrega durante a importação.

Upload prévio: imagens para Media Library, depois referência via URLs Media Library. Sem download durante a importação, mais confiável para grandes volumes.

FAQ

Porque é que o módulo nativo basta em 90 % dos casos?

Porque a maioria das importações são simples: create/update por SKU com mapping direto. Plugins como WP All Import adicionam: mapping com transformações, scheduling, import de XML/JSON, suporte multi-site. Úteis para grandes integrações, raros para uma loja e-commerce clássica.

Importar um CSV WooCommerce sem instalar plugin