Importar produtos no Shopify a partir de CSV ou Excel
A importação CSV do Shopify funciona bem, desde que o arquivo siga exatamente o modelo. Veja o formato exigido, o método passo a passo, os erros que mais bloqueiam e outro caminho: o ListoMax lê seu CSV ou Excel como está e cria cada produto no Shopify pela API Admin.
Por Yvan Barbaggio, criador do ListoMax · Atualizado em
Como importar um arquivo CSV no Shopify?
No painel do Shopify, página Produtos, botão Importar: você envia um arquivo CSV codificado em UTF-8, escolhe duas opções e confere o resumo antes de iniciar.
Abra a importação
No painel do Shopify, abra Produtos, clique em Importar e adicione seu arquivo CSV.
Escolha as opções
Duas caixas: publicar os novos produtos em todos os canais de vendas (marcada por padrão) e substituir os produtos cujo identificador de URL, o handle, já existe. Sem a segunda caixa, os produtos existentes são ignorados.
Confira e importe
O Shopify mostra os detalhes da importação antes de iniciar. Depois de iniciada, ela não pode ser cancelada; um e-mail de confirmação chega no final.
Revise o catálogo
Confira preços, variantes, imagens e coleções. O Shopify não guarda histórico das importações anteriores: anote o que você enviou.
Antes de uma importação grande, faça um teste com três ou quatro produtos. É a forma mais simples de achar uma coluna mal preenchida.
Qual formato de arquivo CSV o Shopify aceita?
Um CSV codificado em UTF-8, colunas separadas por vírgulas, uma primeira linha de cabeçalhos e no máximo 15 MB. Para um produto novo, só o título é obrigatório; quando ele tem variantes, o handle também é.
| Regra | O que o Shopify exige |
|---|---|
| Codificação | UTF-8; caso contrário, os acentos ficam ilegíveis |
| Separador | Uma vírgula entre as colunas; cabeçalhos idênticos ao modelo, inclusive maiúsculas |
| Tamanho | No máximo 15 MB; acima disso, divida o arquivo em vários |
| Colunas obrigatórias | O título para um produto novo; o título e o handle para uma atualização ou um produto com variantes |
| Variantes | Primeira linha: todas as informações do produto. Linhas seguintes: o mesmo handle e os detalhes de cada variante. No máximo três opções (Option1 a Option3) |
| Imagens | Um endereço público em https por linha, no máximo 250 imagens por produto |
| Coleções | Uma única coleção por produto na coluna prevista |
Por que minha importação CSV no Shopify não funciona?
Na maioria das vezes, o problema é o arquivo, não a loja. Estes são os problemas mais comuns e suas causas, segundo a ajuda oficial do Shopify.
Caracteres estranhos no lugar dos acentos
O arquivo não está codificado em UTF-8. Salve-o de novo nesse formato e tente outra vez.
“Unexpected token < in JSON at position 0”
Os cabeçalhos não correspondem ao modelo do Shopify. Eles diferenciam maiúsculas: “title” não é “Title”.
“Illegal quoting”
Um problema de aspas em uma célula: aspas não fechadas ou um arquivo que não está em UTF-8.
“Line is invalid”
Um conflito entre valores de opções nas linhas de um mesmo produto. Confira as colunas Option1 a Option3.
As imagens sumiram
Ordenar o arquivo no Excel ou no Numbers pode separar as linhas de imagens do produto. Evite ordenar um arquivo já pronto.
Informações apagadas
No modo de substituição, uma coluna presente mas vazia troca o valor existente por nada. Retire do arquivo as colunas que você não quer alterar.
Para encontrar esses erros antes da importação, passe o seu arquivo no validador CSV do Shopify gratuito: ele é lido no navegador, nada é enviado.
Como importar um arquivo de fornecedor no Shopify sem refazê-lo?
Mantenha o arquivo como está. O ListoMax lê o CSV, ou a primeira planilha da pasta Excel, reconhece as colunas úteis e cria cada produto no Shopify pela API Admin oficial, com um status por produto.
| Importação CSV do Shopify | Importação no ListoMax | |
|---|---|---|
| Formato | CSV UTF-8 com vírgulas, cabeçalhos do modelo Shopify | CSV ou Excel, separador detectado, cabeçalhos simples |
| Variantes | Uma linha por variante, handle repetido | Eixos digitados uma vez, combinações geradas |
| Imagens | Endereços públicos, um por linha | Vários endereços em uma célula, separados por uma barra vertical |
| Idiomas | Traduções à parte | Uma coluna por idioma, enviada aos idiomas publicados da loja |
| Acompanhamento | E-mail no final, sem histórico | Contador em tempo real, erros numerados |
| Produto existente | Reconhecido pelo handle se a substituição estiver marcada | Reconhecido pelo SKU e atualizado |
| Várias lojas | Uma importação por loja | Shopify, PrestaShop e WooCommerce marcados de uma vez |
| Informação | Cabeçalho reconhecido pelo ListoMax |
|---|---|
| Nome por idioma | name_fr, name_en, name_es, name_de |
| SKU | reference ou sku |
| Preço e promoção | price, sale_price |
| Estoque, peso, código de barras | quantity, weight, ean |
| Classificação | category, tags |
| Textos | description_pt (e outros idiomas) |
| Imagens e visibilidade | images, active |
| SEO | seo_title_pt, seo_desc_pt |
Colunas desconhecidas são ignoradas sem bloquear a importação, e as seis primeiras linhas aparecem antes de iniciar. Um modelo CSV e um modelo Excel podem ser baixados no programa, já preenchidos com um exemplo. Você marca as lojas de destino antes de iniciar; depois, os produtos importados entram no seu catálogo ListoMax, editáveis e republicáveis.
Tudo o que é criado na loja, variantes, coleções, SEO e publicação, está detalhado na página cadastrar produtos em massa no Shopify. Para produtos com opções, veja criar variantes do Shopify em massa. Vende também em outras lojas? Leia a importação CSV e Excel no PrestaShop e a importação de produtos CSV no WooCommerce.
Respostas para as suas dúvidas
O Shopify aceita arquivos Excel?
A importação do Shopify espera um arquivo CSV codificado em UTF-8, com vírgulas entre as colunas. Uma pasta Excel deve então ser salva em CSV, conferindo o separador. O ListoMax lê diretamente a primeira planilha de um arquivo Excel, sem conversão.
Qual o tamanho máximo de um CSV para o Shopify?
15 MB. Acima disso, ou se o envio falhar, o Shopify recomenda dividir o arquivo em vários arquivos menores.
Como importar variantes por CSV no Shopify?
A primeira linha de um produto traz todas as informações; cada linha seguinte repete o mesmo handle e descreve uma variante, com seus valores Option1 a Option3. O Shopify aceita três opções e até 2.048 variantes por produto.
Dá para atualizar produtos existentes do Shopify por CSV?
Sim, marcando a opção que substitui os produtos com o mesmo handle. Atenção: uma coluna presente mas vazia apaga o valor existente. No ListoMax, um produto existente é reconhecido pelo SKU e atualizado.
Dá para testar a importação sem risco?
Sim. O teste gratuito do ListoMax oferece 5 publicações reais, sem cartão de crédito. Publique seus testes como rascunho: o produto é criado no Shopify, mas fica invisível para seus clientes. As licenças estão na página de preços.
Teste na sua loja Shopify
5 publicações reais grátis, sem cartão de crédito. Depois, uma licença vitalícia: €49 para um computador, €149 para até 5 computadores.