Como exportar dados do Shopify e importar produtos por CSV
Este guia mostra as formas mais comuns de importar e exportar dados do Shopify em massa: a importação CSV do próprio Shopify, um modelo de colunas pronto para copiar, soluções para importações CSV que falham e como mover produtos, imagens, metacampos, pedidos e clientes.
Alterações em massa são a forma mais rápida de atualizar uma loja. Também são a forma mais rápida de quebrar uma, porque uma única coluna errada pode afetar milhares de registros. Por isso, cada método deste guia começa com um backup e termina com um caminho de volta.
Pela equipe BluePeacock11 min de leitura
- 1Seu arquivo CSV ou Excel
- 2Teste: nada muda ainda
- 3Sua loja Shopify
- Desfazer com um clique
Principais pontos
O admin do Shopify importa produtos e clientes de arquivos CSV em UTF-8 de até 15 MB. Este guia traz as colunas, um modelo, soluções para os erros mais comuns e um jeito seguro de fazer grandes importações e exportações.
- Comece com uma exportação da sua própria loja: ela tem todas as colunas na ordem certa.
- Salve como CSV UTF-8, escreva os cabeçalhos exatamente como o Shopify e use links de imagem públicos com https.
- Com a substituição ativada, o Shopify apaga um valor quando a célula dele está vazia. Em vez disso, deixe a coluna de fora.
- A Central de Ajuda da Shopify, consultada em 6 de novembro de 2026, não descreve importação de pedidos nem forma de desfazer.
- Teste antes toda importação grande e guarde um backup exportado, para poder reverter um erro.
1Duas formas de importar e exportar dados do Shopify em massa
O admin do Shopify tem uma ferramenta CSV gratuita. Segundo a Central de Ajuda da Shopify, consultada em 6 de novembro de 2026, ela importa produtos e clientes de arquivos CSV e exporta produtos, clientes e pedidos. Ela serve para arquivos de produtos pequenos, montados com cuidado.
| CSV do admin do Shopify | BluePeacock | |
|---|---|---|
| Arquivos que lê | Somente CSV em UTF-8 | CSV, Excel e links do Google Sheets, em UTF-8 ou na codificação antiga do Windows |
| Células vazias na atualização | Apagam o valor existente ao sobrescrever | Mantêm o valor existente sem alteração |
| Encontra produtos existentes por | Handle da URL | ID do produto, handle ou SKU |
| Depois que a importação começa | Não pode ser cancelada; sem histórico de importações | Cancele uma tarefa em andamento; toda tarefa fica salva com seus arquivos |
| Desfazer | Não descrito | Desfazer com um clique a partir dos valores antigos salvos |
| Agendamentos | Não descrito | Agende importações e exportações |
2Como importar produtos no Shopify com um arquivo CSV
A importação de produtos do próprio Shopify funciona assim:
- 1Baixe o CSV de exemplo de produtos do Shopify, ou exporte alguns produtos para ter as colunas exatas da sua loja.
- 2Preencha uma linha por produto, e uma linha extra para cada variante ou imagem adicional.
- 3Salve o arquivo como CSV em UTF-8.
- 4No admin do Shopify, acesse Produtos e clique em Importar.
- 5Escolha o arquivo. Marque "Overwrite products with matching handles" (substituir produtos com o mesmo handle) só se você quiser substituir os valores existentes.
- 6Envie o arquivo e inicie a importação.
3Limites da importação CSV do Shopify que você precisa conhecer
A Central de Ajuda da Shopify, consultada em 6 de novembro de 2026, define estas regras:
4Modelo de CSV de produtos do Shopify: as colunas necessárias
O arquivo de exemplo atual do Shopify começa com Title e URL handle. O URL handle liga cada linha a um produto, então todas as linhas com o mesmo handle pertencem ao mesmo produto. Os cabeçalhos precisam ser escritos exatamente como no Shopify.
A maioria das importações de produtos só precisa destas colunas:
| Coluna | O que vai nela |
|---|---|
| Title e URL handle | o nome do produto e o endereço da página dele. |
| Description, Vendor, Type e Tags | |
| Status | por exemplo Active ou Draft. |
| Option1 name e Option1 value | por exemplo Tamanho e P. Até três opções. |
| SKU, Price e Compare-at price | |
| Inventory quantity | só para lojas com um único local. |
| Product image URL e Image position | |
| SEO title e SEO description |
| Title | URL handle | Vendor | Status | SKU | Price | Product image URL | Image position |
|---|---|---|---|---|---|---|---|
| Linen shirt | linen-shirt | Harbor Co | Active | LS-01 | 39.00 | https://example.com/linen-front.jpg | 1 |
| linen-shirt | https://example.com/linen-back.jpg | 2 | |||||
| Wool scarf | wool-scarf | Harbor Co | Draft | WS-01 | 25.00 | https://example.com/scarf.jpg | 1 |
5Como importar várias imagens por produto
Segundo a Central de Ajuda da Shopify, consultada em 6 de novembro de 2026, um produto pode ter até 250 imagens. Cada imagem precisa de uma linha própria:
- 1Preencha a primeira linha com o produto e a URL da primeira imagem.
- 2Adicione uma linha nova para cada imagem extra. Preencha só o URL handle e o Product image URL.
- 3Defina Image position como 1, 2, 3 para as imagens aparecerem nessa ordem.
6Como importar metacampos com um CSV
O CSV de produtos do Shopify aceita metacampos de produto como colunas extras. O cabeçalho dá o nome do metacampo, por exemplo "Fabric (product.metafields.custom.fabric)". Segundo a Central de Ajuda da Shopify, consultada em 6 de novembro de 2026, metacampos de variantes não são aceitos, e o CSV de clientes aceita só alguns tipos simples de metacampo.
7Importação CSV do Shopify não funciona? Erros comuns e soluções
Estes erros e soluções vêm da Central de Ajuda da Shopify, consultada em 6 de novembro de 2026, mais um hábito do Excel que causa muitos problemas:
| Erro ou sintoma | Como resolver |
|---|---|
| "Illegal quoting" ou "Missing or stray quote" (aspas inválidas ou soltas) | o Excel colocou aspas curvas, ou o arquivo não está em UTF-8. Salve como CSV UTF-8 e troque as aspas curvas por aspas retas. |
| Símbolos estranhos no lugar de letras acentuadas | o arquivo não está em UTF-8. Salve de novo em UTF-8. |
| "Invalid CSV header" (cabeçalho CSV inválido) ou uma janela "Choose column headings" (escolher cabeçalhos de coluna) | um cabeçalho está escrito errado ou tem um espaço no final. Os cabeçalhos diferenciam maiúsculas de minúsculas, então copie-os do arquivo de exemplo do Shopify. |
| "An error occurred while trying to download the image" (erro ao baixar a imagem) | a URL da imagem não é pública ou não começa com http:// ou https://. |
| "Ignored line … because it did not contain product data" (linha ignorada por não conter dados de produto) | uma linha tem handle, mas não tem Title. |
| "Options are not unique" (as opções não são únicas) | duas variantes têm os mesmos valores de opção. |
| "Price can't be blank" ou "Inventory quantity is not a number" | preencha a célula com um número simples. |
| Imagens somem depois de uma importação | o arquivo foi ordenado no Excel, e o Shopify avisa que isso pode quebrar os links das imagens. Não ordene um arquivo de produtos. |
| Códigos de barras viram números como 4.00638E+12 | o Excel os arredondou. Formate a coluna como Texto antes de colar. |
8Como exportar produtos do Shopify para CSV ou Excel
O admin do Shopify exporta produtos só em CSV. Segundo a Central de Ajuda da Shopify, consultada em 6 de novembro de 2026, CSV em UTF-8 é o único formato que ele consegue importar ou exportar, e a coluna Collection não vem na exportação.
Com o BluePeacock, você escolhe o formato e as colunas:
- 1Abra Exportar e escolha Produtos, ou Variantes para ter todas as colunas de opções, preços e estoque.
- 2Escolha as colunas, incluindo URLs de imagens e metacampos.
- 3Filtre por status, fornecedor, tipo de produto, tags ou data de criação.
- 4Escolha CSV ou Excel.
- 5Baixe o arquivo ou, em um plano pago, envie para FTP, SFTP, WebDAV ou Google Drive.
- 6Rode agora, mais tarde ou em uma programação recorrente, como um backup semanal.
9Como exportar pedidos do Shopify
No admin do Shopify, abra Pedidos e clique em Exportar. Segundo a Central de Ajuda da Shopify, consultada em 6 de novembro de 2026, até 50 pedidos são baixados na hora, e uma exportação maior é enviada para você por e-mail.
10Como importar e exportar clientes
O CSV de clientes do Shopify aceita nomes, e-mail, telefone, um endereço padrão, consentimento de marketing, tags, uma observação e isenção de impostos. Segundo a Central de Ajuda da Shopify, consultada em 6 de novembro de 2026, o arquivo pode ter até 15 MB, e-mails ou telefones duplicados são ignorados e senhas não podem ser transferidas.
11Dá para importar pedidos no Shopify?
Não pelo admin do Shopify. A Central de Ajuda da Shopify, consultada em 6 de novembro de 2026, descreve a exportação de pedidos, mas nenhuma importação de pedidos.
Para trazer o histórico de pedidos, você precisa de um app que crie pedidos. O BluePeacock importa pedidos e rascunhos de pedido de CSV ou Excel. A página do Matrixify na Shopify App Store, consultada em 6 de novembro de 2026, também lista a importação de pedidos.
12Como importar produtos de outra loja
Do WooCommerce: em um plano pago, conecte sua loja com o endereço e as chaves de API, e o BluePeacock lê os produtos. Ou exporte um CSV de produtos do WooCommerce e importe esse arquivo em qualquer plano.
De qualquer outra plataforma: exporte um CSV de produtos e associe as colunas aos campos do Shopify. O BluePeacock sugere correspondências próximas, mas nunca adivinha por você.
De outra loja Shopify: exporte os produtos de uma loja e importe o arquivo na outra.
Compare apps de migração e importação para Shopify13O jeito seguro de fazer qualquer importação grande
Seja o que for que você vai mover, estes seis passos mantêm sua loja segura:
- 1Exporte um backup dos dados que você vai alterar. Ele também serve de modelo, com colunas iguais às da sua loja.
- 2Prepare o arquivo. Inclua uma coluna de identificação, como um ID de produto, handle ou SKU, para que os registros sejam atualizados, e não duplicados. Deixe a célula vazia quando não quiser alterá-la: o BluePeacock não mexe em células vazias.
- 3Associe cada coluna a um campo do Shopify.
- 4Revise cada alteração. O BluePeacock faz um teste que não altera nada e mostra cada registro antes e depois.
- 5Rode agora ou programe. O BluePeacock salva o valor antigo de cada campo antes de gravar.
- 6Desfaça se algo der errado. Abra a tarefa e os valores antigos salvos voltam com um clique. Imagens que você removeu não voltam, porque o Shopify apaga os arquivos.
Um teste pega o erro antes de ele chegar à sua loja. Os valores antigos salvos e o desfazer com um clique corrigem os que escaparem. E, se você travar, uma pessoa da BluePeacock responde em até 24 horas.
Teste o BluePeacock Import & Export grátisConfigurações da loja, dados de clientes e backups que você pode mover
- Políticas da loja
- Importe e exporte as políticas de reembolso, privacidade, termos de serviço e frete.
- Configuração de frete
- Importe e exporte perfis, zonas e tarifas de frete.
- Segmentos de clientes
- Importe e exporte segmentos de clientes.
- Backups dos arquivos do tema
- Exporte os arquivos do tema como um backup com data. Importar arquivos de tema exige uma permissão especial da Shopify.
- Transferências de estoque
- Importe e exporte transferências de estoque entre locais.
- Planos de assinatura e pré-venda
- Exporte planos de venda por assinatura e em pré-venda.
- Shopify Markets
- Importe e exporte a sua configuração do Markets.
- Crédito na loja
- Exporte os saldos de crédito na loja dos clientes.
- Checkouts abandonados
- Somente exportação. Requer aprovação da Shopify para acessar dados protegidos dos clientes.
- Cartões-presente
- Vai mover cartões-presente? O BluePeacock Gift Card Importer traz os cartões para o Shopify com os códigos e saldos originais.
Perguntas sobre importação e exportação no Shopify
Como importar produtos em massa no Shopify?
Crie um arquivo CSV com uma linha por produto, variante ou imagem extra, salve em UTF-8 e, no admin do Shopify, acesse Produtos e clique em Importar. Para usar arquivos Excel, fazer um teste antes de gravar e desfazer com um clique, use um app de importação como o BluePeacock Import & Export.
Onde encontro um modelo de CSV de produtos do Shopify?
A Central de Ajuda da Shopify tem um link para um CSV de exemplo de produtos. Um começo mais rápido é exportar um dos seus próprios produtos: o arquivo tem todas as colunas na ordem que a sua loja usa.
Por que minha importação CSV no Shopify não funciona?
As causas mais comuns são um arquivo que não foi salvo em UTF-8, aspas curvas colocadas pelo Excel, um cabeçalho de coluna escrito errado ou uma URL de imagem que não é pública. Cada uma tem uma solução na lista de erros deste guia.
Qual é o tamanho máximo de arquivo para uma importação CSV no Shopify?
Segundo a Central de Ajuda da Shopify, consultada em 6 de novembro de 2026, arquivos CSV de produtos e de clientes não podem ter mais de 15 MB. Divida arquivos maiores.
Dá para importar metacampos com um CSV do Shopify?
Sim, metacampos de produto vão em colunas extras com o nome do metacampo, por exemplo "Fabric (product.metafields.custom.fabric)". Segundo a Central de Ajuda da Shopify, consultada em 6 de novembro de 2026, metacampos de variantes não são aceitos. Crie a definição do metacampo antes de importar.
Como adicionar várias imagens a um produto em um CSV?
Adicione uma linha por imagem. Em cada linha extra, preencha só o URL handle e o Product image URL, e use Image position para definir a ordem. Cada URL precisa ser pública.
Dá para importar pedidos no Shopify?
Não pelo admin do Shopify: a Central de Ajuda, consultada em 6 de novembro de 2026, descreve a exportação de pedidos, mas nenhuma importação de pedidos. Você precisa de um app que crie pedidos. O BluePeacock importa pedidos e rascunhos de pedido.
Como exportar produtos do Shopify para Excel?
O admin do Shopify exporta em CSV, que o Excel abre. Para ter um arquivo Excel de verdade com as colunas que você escolher, exporte com o BluePeacock e escolha Excel como formato.
Dá para desfazer uma importação CSV no Shopify?
Segundo a Central de Ajuda da Shopify, consultada em 6 de novembro de 2026, uma importação não pode ser cancelada depois de iniciada, e não há nenhuma forma de desfazer descrita. O BluePeacock salva o valor antigo de cada campo antes de gravar, então uma importação concluída pode ser desfeita com um clique.
Sobre este guia
Escrito pela equipe BluePeacock, que cria apps do Shopify para dados em massa e cartões-presente. Cada informação sobre o Shopify aqui foi conferida na Central de Ajuda da Shopify em 6 de novembro de 2026.