Guia
Como importar produtos em massa para a Shopify
A Shopify consegue criar ou atualizar muitos produtos de uma só vez a partir de um arquivo CSV. Veja como funciona a importação, onde ela se complica e o que fazer quando os dados dos seus produtos nascem em PDFs de fornecedores.
A importação de CSV de produtos da Shopify é a forma padrão de adicionar um catálogo em massa. Você prepara uma planilha no formato da Shopify, carrega-a no painel de administração e a Shopify cria os produtos, as variantes e as imagens.
Como em qualquer importação, o sucesso depende dos dados que você insere. Este guia aborda o processo com CSV, as alternativas e a preparação que evita ter de corrigir centenas de produtos depois.
Opção 1: importar um CSV de produtos no painel da Shopify
No painel de administração da Shopify, vá para Produtos e escolha Importar. Carregue um CSV no formato de produtos da Shopify, decida se os produtos com handles correspondentes devem ser substituídos, visualize a prévia e confirme. A Shopify processa o arquivo em segundo plano e avisa quando terminar.
- Comece a partir do modelo de CSV de produtos de exemplo da Shopify, ou exporte um produto existente para ver as colunas exatas.
- A coluna URL handle (Handle nos modelos mais antigos) identifica um produto; as linhas que partilham o mesmo handle são variantes ou imagens adicionais do mesmo produto.
- As colunas comuns incluem Title, Description (Body (HTML)), Vendor, Product category, Type, Tags, Status, Option1 name / Option1 value, SKU (Variant SKU), Price, Barcodes (Variant Barcode) e Product image URL (Image Src).
- As imagens são obtidas de URLs públicos no momento da importação.
- Salve o arquivo como CSV em UTF-8 para manter os caracteres especiais intactos.
Como tratar as variantes corretamente
As variantes são o que faz tropeçar a maioria das primeiras importações. Cada produto pode ter até três opções (por exemplo, Tamanho, Cor, Material). A primeira linha de um produto contém os campos no nível do produto e os nomes das opções; cada linha seguinte com o mesmo handle acrescenta uma variante com os respectivos valores de opção, SKU, preço e estoque.
Mantenha os nomes das opções idênticos em todas as linhas e a combinação de valores de opção de cada variante única, para que cada linha corresponda exatamente a uma variante. Uma linha que tenha colunas de variante, mas não tenha Option1 name nem Option1 value, faz com que a Shopify crie uma variante predefinida e elimine as existentes.
Opção 2: aplicações de importação em massa
As aplicações de importação da Shopify App Store ampliam o CSV nativo: suporte a Excel e Google Sheets, metafields, importações agendadas a partir de feeds de fornecedores e migração de outras plataformas. Vale a pena considerá-las quando você importa repetidamente ou precisa de campos que o CSV padrão não cobre.
Opção 3: a Admin API da Shopify
As aplicações e as integrações personalizadas podem criar produtos através da Admin API da Shopify em vez de um ficheiro CSV. Isto evita por completo os vaivéns com folhas de cálculo e é como muitas ferramentas de catálogo e de listagens criam produtos na Shopify.
O Doc2Shelf segue este caminho: liga a sua loja por OAuth e as listagens revistas são criadas como produtos em rascunho, com imagens, preços e categorias.
Preparar os dados de produto para a Shopify
Antes de qualquer importação em massa, confirme que:
- Cada produto tem um handle único e cada variante um SKU único.
- Os títulos seguem um único padrão (por exemplo, Marca + Produto + Atributo principal).
- As descrições são texto seu, não texto de fornecedor colado, e usam HTML simples.
- As especificações usam unidades e nomes consistentes, para poderem se tornar opções, tags ou metafields.
- Os produtos são importados primeiro como não publicados, para você poder revisar uma amostra antes de publicar tudo.
Quando os dados de produto vêm de PDFs de fornecedores
Uma importação por CSV pressupõe que você já tem dados limpos e estruturados. Quando os fornecedores enviam folhas de especificações e catálogos em PDF, alguém tem primeiro de extrair títulos, especificações e identificadores e redigir descrições — geralmente a parte mais lenta de todo o trabalho.
O Doc2Shelf substitui essa etapa: lê os PDFs dos fornecedores, extrai os dados de produto com informação de confiança para revisão, redige o texto da listagem Shopify e cria os produtos revistos, como rascunhos, na sua loja ligada, sem CSV.
Colunas do CSV de produtos da Shopify: nomes atuais e equivalentes mais antigos
A Shopify mudou o nome de várias colunas do CSV de produtos. A sua referência atual do CSV usa etiquetas como URL handle, Description, SKU e Barcodes, enquanto muitos modelos e tutoriais ainda mostram Handle, Body (HTML), Variant SKU e Image Src. A Shopify afirma que mantém a compatibilidade com os nomes de colunas mais antigos, pelo que um ficheiro antigo continua a ser importado — mas uma exportação nova usa as etiquetas atuais, e um ficheiro que mistura os dois estilos é difícil de verificar.
A tabela abrange as colunas de que a maioria das importações em massa precisa. A mudança de Barcode para Barcodes está indicada na documentação da Shopify; as outras etiquetas mais antigas são associadas pelo que cada campo contém, por isso confirme-as com uma exportação da sua própria loja. Os cabeçalhos distinguem maiúsculas de minúsculas.
| Coluna atual | O que contém | Exemplo | Etiqueta mais antiga ou notas |
|---|---|---|---|
| Title | Nome do produto | Chaleira em aço inoxidável 1.7 L | Obrigatório para criar um produto. |
| URL handle | Identificador único do produto usado no URL do produto | steel-kettle | Os modelos mais antigos chamam-lhe Handle. As linhas que partilham um handle pertencem ao mesmo produto. |
| Description | Descrição do produto | Chaleira sem fios com… | Os modelos mais antigos chamam-lhe Body (HTML). |
| Vendor | Marca ou fabricante | Acme | — |
| Product category | Categoria da Standard Product Taxonomy | hg-15-1-2 | Breadcrumb completo ou ID da categoria, não ambos. |
| Type | O seu próprio tipo de produto | Chaleira elétrica | Texto livre, ao contrário da categoria. |
| Tags | Etiquetas separadas por vírgulas | sem fios, cozinha | Até 250 etiquetas por produto. |
| Status | Estado do produto | draft | Importe como rascunho, reveja e só depois ative. |
| SKU | SKU da variante | KTL-SLV | Os modelos mais antigos chamam-lhe Variant SKU. |
| Barcodes | Códigos de barras da variante | gtin:4006381333931 | Anteriormente Barcode (e, antes disso, Variant Barcode). Separe vários com pontos e vírgulas; o prefixo do tipo é opcional. |
| Option1 name / Option1 value | Primeira opção e o valor desta variante | Cor / Prateado | Option2 e Option3 seguem o mesmo padrão. |
| Option1 LinkedTo | Ligação da opção a um metacampo de categoria | product.metafields.shopify.[attribute] | Opcional; consulte a secção sobre taxonomia abaixo. |
| Price / Compare-at price | Preço de venda e preço de comparação | 49.90 / 59.90 | As colunas Price / [Market] contêm preços específicos de cada mercado. |
| Inventory quantity | Stock disponível | 25 | Funciona em conjunto com a coluna Inventory tracker. |
| Weight value (grams) | Peso da variante em gramas | 1200 | Os modelos mais antigos chamam-lhe Variant Grams. Weight unit for display define a unidade que os compradores veem. |
| Product image URL | URL público de uma imagem do produto | https://cdn.example.com/kettle.jpg | Os modelos mais antigos chamam-lhe Image Src. |
| Image position / Image alt text | Ordem na galeria e texto alternativo | 1 / Chaleira de aço, vista frontal | Texto alternativo até 512 carateres. |
| Variant image URL | Imagem apresentada quando esta variante é selecionada | https://cdn.example.com/kettle-black.jpg | — |
| SEO title / SEO description | Título e meta descrição para os resultados de pesquisa | — | Até 70 e 320 carateres. |
| Metafield columns | Valores dos metacampos do produto | Material (product.metafields.custom.material) | Formato do cabeçalho: Name (product.metafields.namespace.key). |
Variantes e opções: limites e armadilhas
Um produto Shopify pode ter até três opções — por exemplo Tamanho, Cor e Material — e até 2048 variantes. O limite de variantes era 100 até a Shopify o aumentar em outubro de 2025, pelo que os modelos e guias escritos antes ainda citam o número antigo. Alguns temas, aplicações e canais de venda foram construídos em torno do limite antigo, por isso verifique os seus antes de importar um produto com centenas de variantes.
A primeira linha de um produto contém os campos ao nível do produto e os nomes das opções. Cada linha seguinte com o mesmo URL handle acrescenta uma variante com o respetivo valor de opção, SKU, preço, peso e inventário, e deixa vazios os campos ao nível do produto.
Dois comportamentos apanham de surpresa as importações de atualização. Se uma linha incluir colunas de variante como SKU ou peso, mas omitir Option1 name e Option1 value, a Shopify cria uma variante predefinida e elimina as variantes existentes. E alterar um valor de opção — mudar “Cinzento” para “Cinza”, por exemplo — elimina os IDs das variantes e cria novos, o que pode afetar aplicações e feeds que referenciam esses IDs.
| Linha | URL handle | Title | Option1 name | Option1 value | SKU |
|---|---|---|---|---|---|
| Primeira linha | steel-kettle | Chaleira de aço | Cor | Prateado | KTL-SLV |
| Linha seguinte | steel-kettle | (vazio) | (vazio) | Preto | KTL-BLK |
Imagens de produto num CSV da Shopify
A Shopify descarrega as imagens a partir da coluna Product image URL durante a importação, por isso cada URL tem de ser acessível publicamente e apontar diretamente para o ficheiro de imagem. As ligações que exigem início de sessão, abrem uma página de pré-visualização ou expiram antes de a importação decorrer são os motivos habituais para as imagens não aparecerem.
Um produto pode ter até 250 imagens ou outros ficheiros multimédia. Coloque a primeira imagem na primeira linha do produto; acrescente cada imagem seguinte na sua própria linha, com o mesmo URL handle, o URL da imagem, a respetiva Image position e o respetivo Image alt text. Para mostrar uma imagem específica quando o comprador escolhe uma variante, coloque o respetivo URL em Variant image URL na linha dessa variante.
O texto alternativo pode ter até 512 carateres, e a Shopify recomenda 125 ou menos. Descreva o que a imagem mostra — “Chaleira de aço inoxidável, vista frontal com indicador de nível de água” — em vez de repetir o título do produto.
Product category, metacampos e a Standard Product Taxonomy
A coluna Product category atribui uma categoria da Standard Product Taxonomy da Shopify, escolhida pela função principal do produto. Introduza o breadcrumb completo, como Home & Garden > Linens & Bedding > Bedding > Bed Sheets, ou o ID da categoria, como hg-15-1-2 — não ambos. Um produto sem categoria é tratado como não categorizado.
Definir uma categoria desbloqueia os respetivos metacampos de categoria, a que a taxonomia chama atributos de produto. A categoria Shirts da Shopify, por exemplo, tem nove, incluindo tamanho, decote, tecido e cor, e os valores de cor podem ser apresentados como amostras. A coluna Option1 LinkedTo liga uma opção de variante a um destes metacampos de categoria.
A categoria importa para além da navegação: a Shopify Tax usa-a para definir as taxas de imposto. O Type, por outro lado, é uma etiqueta de texto livre que define por si, útil para os seus filtros e relatórios.
Os metacampos personalizados de produto são importados através de colunas com o cabeçalho Name (product.metafields.namespace.key), por exemplo Material (product.metafields.custom.material). Os metacampos de variante não são suportados no CSV de produtos, por isso defina-os no painel de administração, com uma aplicação ou através da API.
Limites do CSV da Shopify e extensão dos campos SEO
Estes são os limites que a Shopify documenta para as importações de CSV de produtos e para os registos de produtos. Os números de guias mais antigos — em especial o limite de 100 variantes — estão desatualizados.
As colunas SEO title e SEO description preenchem o título e a meta descrição usados nos resultados de pesquisa. Escreva-os por produto, em vez de copiar um único padrão para todo o catálogo: comece pelo nome do produto e pelo atributo que os compradores pesquisam, como o tamanho, o material ou o número de modelo.
| Item | Limite | O que fazer |
|---|---|---|
| Tamanho do ficheiro CSV | 15 MB | Divida os catálogos grandes; mantenha todas as linhas de um produto no mesmo ficheiro. |
| Opções por produto | 3 | Modele as restantes diferenças como produtos separados ou metacampos. |
| Variantes por produto | 2048 | Verifique se o seu tema e as suas aplicações lidam com um grande número de variantes. |
| Imagens e ficheiros multimédia por produto | 250 | Limite a galeria às imagens que ajudam os compradores a decidir. |
| Etiquetas por produto | 250 | Use as etiquetas para filtragem e automatização. |
| Códigos de barras por produto ou variante | 20 | Acrescente um prefixo de tipo, como gtin:, quando souber o tipo. |
| Título SEO | 70 carateres | Comece pelo nome do produto e pelo atributo principal. |
| Descrição SEO | 320 carateres | Resuma o produto, com os dados principais primeiro. |
| Texto alternativo da imagem | 512 carateres (recomendam-se 125 ou menos) | Descreva o que a imagem mostra. |
Substituir ou criar: como se comportam as atualizações
Para criar um produto, o CSV só precisa de um Title; para adicionar variantes é necessário também o URL handle. Para atualizar um produto existente, a Shopify precisa do URL handle e do Title, e pode optar por substituir os produtos com handles correspondentes ao iniciar a importação.
Trate uma substituição como definitiva para todas as colunas que incluir. O padrão mais seguro é exportar, editar e reimportar: exporte os produtos que quer alterar, edite apenas as células que precisam de alteração, mantenha as colunas de opções no lugar e importe o ficheiro editado com a substituição ativada. Um ficheiro esparso criado de raiz facilita desencadear o comportamento de eliminação de variantes descrito acima.
Leia a pré-visualização da importação antes de confirmar e execute primeiro uma atualização grande num punhado de produtos. A exportação que fez antes de editar é o seu caminho de volta se algo correr mal.
Checklist pré-importação e resolução de problemas
Percorra estes passos antes de uma importação grande; a tabela que se segue abrange os problemas mais frequentes.
- Exporte um produto da sua loja e reutilize a respetiva linha de cabeçalhos, para que os nomes das colunas coincidam exatamente.
- Atribua a cada produto um URL handle único e a cada variante um SKU único.
- Verifique se os nomes e valores das opções têm grafia coerente e confirme que cada linha de variante tem o seu valor de opção.
- Preencha Product category com um breadcrumb ou um ID copiado da taxonomia.
- Abra uma amostra de URLs de imagens numa janela privada do navegador para confirmar que carregam sem início de sessão.
- Defina Status como draft na primeira execução.
- Guarde como CSV UTF-8 e confirme que o ficheiro tem menos de 15 MB.
- Importe de cinco a dez produtos, reveja-os no painel de administração e na loja e depois importe os restantes.
| Problema | Causa provável | Solução |
|---|---|---|
| Ficheiro rejeitado | Superior a 15 MB, ou não guardado como CSV UTF-8 | Divida o ficheiro por produto e volte a guardá-lo como CSV UTF-8 |
| Coluna ignorada | Cabeçalho com erro ortográfico ou com maiúsculas diferentes | Copie os cabeçalhos de uma exportação nova |
| Variantes desaparecidas após uma atualização | Colunas de variante enviadas sem Option1 name e value | Reimporte com as colunas de opções incluídas |
| As aplicações perderam o rasto das variantes | Um valor de opção foi renomeado, criando novos IDs de variante | Renomeie os valores de opção de forma deliberada e volte a ligar as aplicações afetadas |
| Produtos separados ou fundidos incorretamente | O URL handle difere entre as linhas de um mesmo produto | Use um único handle idêntico por produto |
| Imagens em falta | URL não público, não é uma ligação direta ao ficheiro ou expirou | Aloje as imagens em URLs públicos estáveis |
| Categoria não definida | Breadcrumb escrito incorretamente, ou indicados o breadcrumb e o ID | Use exatamente um, copiado da taxonomia |
| Código de barras não aceite | O comprimento não corresponde ao tipo indicado | GTIN: 8, 12, 13 ou 14 dígitos; UPC: 8 ou 12; EAN: 8 ou 13 |
| Valores de metacampos em falta | Formato de cabeçalho errado, ou um metacampo de variante | Use Name (product.metafields.namespace.key); defina os metacampos de variante noutro local |
Perguntas frequentes
- Como importar produtos em massa para a Shopify gratuitamente?
- Use a importação de CSV integrada em Produtos → Importar. Está incluída em todos os planos da Shopify e trata produtos, variantes e imagens a partir de um arquivo CSV no formato da Shopify.
- Posso carregar produtos para a Shopify a partir do Excel?
- O importador nativo precisa de CSV, por isso salve a sua planilha do Excel como CSV em UTF-8 com os nomes de coluna da Shopify. Algumas aplicações de importação conseguem ler arquivos Excel diretamente.
- Uma importação de CSV vai substituir os meus produtos existentes?
- Os produtos existentes só são atualizados quando você escolhe a opção de substituir os produtos com handles correspondentes. Revise a prévia da importação antes de confirmar e teste primeiro com um arquivo pequeno.
- Por que as minhas imagens não são importadas?
- Os URLs das imagens têm de ser links diretos, de acesso público, para arquivos de imagem. Os links que exigem login, redirecionam para uma página web ou vêm de um comcompartilhamento temporário de arquivos costumam falhar.
- Que colunas são obrigatórias num CSV de produtos da Shopify?
- Só o Title é necessário para criar um produto, mais o URL handle quando se adicionam variantes. Para atualizar produtos existentes, inclua o URL handle e o Title. Tudo o resto é opcional, embora uma listagem utilizável precise normalmente de preço, SKU, categoria, descrição e imagens.
- Quantas variantes pode ter um produto Shopify?
- Até 2.048 variantes, com um máximo de três opções. A Shopify aumentou o limite de 100 em outubro de 2025, pelo que os modelos e guias mais antigos que indicam 100 estão desatualizados.
- Posso importar metacampos com um CSV da Shopify?
- Os metacampos de produto, sim: adicione uma coluna com o cabeçalho Name (product.metafields.namespace.key). Os metacampos de variante não são suportados no CSV de produtos e têm de ser definidos no painel de administração, com uma aplicação ou através da API.
- Qual é o tamanho máximo de um CSV de produtos da Shopify?
- Um CSV de produtos não pode exceder 15 MB. Divida os catálogos maiores em vários ficheiros e mantenha todas as linhas de um produto no mesmo ficheiro.