Usar arquivos CSV

Use arquivos CSV (valores separados por vírgulas) para importar e exportar produtos de sua loja da Shopify. Com arquivos CSV, é possível importar ou exportar grandes quantidades de produtos e informações de uma só vez. Isso pode ser útil para trocar informações em massa sobre produtos entre a Shopify e outro sistema.

Saiba como abrir e editar um arquivo CSV.

Obter um exemplo de arquivo CSV

Você pode baixar e visualizar um arquivo CSV de amostra de produto para utilizar como um modelo:

  • O arquivo de amostra contém um exemplo de produto e algumas variantes. É provável que seu arquivo de importação contenha um número muito maior de produtos e variantes. Se você usar o arquivo de amostra para criar seu próprio arquivo de importação, remova todas as amostras de produtos fictícios.

  • O arquivo de amostra inclui a coluna Variant Inventory Qty, que é usada apenas para lojas que possuem um único local. Se você utiliza vários locais e quiser importar ou exportar volumes de estoque, use o arquivo CSV de estoque.

Formato do arquivo CSV de produtos

A primeira linha de um arquivo CSV de produtos precisa incluir os campos de cabeçalho descritos na tabela, seguindo a mesma ordem e separados por vírgula. As linhas seguintes do arquivo precisam conter dados de produtos usando os mesmos campos e seguindo a mesma ordem.

Se uma coluna estiver em branco e você optar por substituir produtos com o mesmo identificador ao carregar o arquivo CSV, isso poderá excluir dados relacionados à coluna de sua loja da Shopify. Para saber mais, consulte a tabela abaixo.

Handle

Os identificadores são os nomes exclusivos de cada produto. Eles podem conter letras, traços e números, mas nenhum espaço ou outros caracteres, incluindo pontos. Há um identificador na URL de cada produto.

Por exemplo, o identificador para "Prancha de snowboard feminina" seria prancha-de-snowboard-feminina e a URL do produto seria https://yourstore.myshopify.com/products/prancha-de-snowboard-feminina.

Cada linha do arquivo CSV que começa com um identificador diferente é tratada como um novo produto. Para adicionar várias imagens a um produto, é preciso incluir várias linhas com o mesmo identificador.

A coluna Identificador não pode estar em branco ou ausente.

Title

O título de seu produto. Exemplo: Prancha de snowboard feminina

A coluna Título não pode ficar em branco nem estar ausente.

Body (HTML)

A descrição do produto em formato HTML. Também pode ser um texto simples, simples.

A coluna Corpo (HTML) pode ficar em branco, mas não pode estar ausente. Se você deixar a coluna em branco e marcar a opção Substituir os produtos atuais que tenham o mesmo identificador. Os valores existentes serão usados para colunas ausentes. ao carregar o arquivo CSV, as descrições serão excluídas.

Vendor (mín. 2 caracteres)

O nome do fornecedor do produto. Por exemplo, Nevasca Equipamentos esportivos.

A coluna Fornecedor pode ficar em branco, mas não pode estar ausente. Se você deixar a coluna em branco e marcar a opção Substituir os produtos atuais que tenham o mesmo identificador. Os valores existentes serão usados para colunas ausentes. ao carregar o arquivo CSV, os nomes dos fornecedores serão excluídos.

Type

O tipo de produto. Por exemplo, Prancha de snowboard.

A coluna Tipo pode ficar em branco, mas não pode estar ausente. Se você deixar a coluna em branco e marcar a opção Substituir os produtos atuais que tenham o mesmo identificador. Os valores existentes serão usados para colunas ausentes. ao carregar o arquivo CSV, os tipos de produto serão excluídos.

Tags

Uma lista de tags separadas por vírgula para classificar os produtos. A maioria dos apps de planilha já adiciona aspas às tags automaticamente. Caso você use um editor de texto simples, é preciso adicionar as aspas manualmente. Por exemplo, "tag1, tag2, tag3".

A coluna Tags pode ficar em branco, mas não pode estar ausente. Se você deixar a coluna em branco e marcar a opção Substituir os produtos atuais que tenham o mesmo identificador. Os valores existentes serão usados para colunas ausentes. ao carregar o arquivo CSV, as tags de produto serão excluídas.

Published

Indica se o produto está publicado em sua loja virtual. Os valores válidos são TRUE, se o produto está publicado em sua loja virtual, ou FALSE, se o produto está oculto em sua loja virtual.

A coluna Publicado não pode estar ausente. O produto será publicado se o campo ficar em branco.

Option1 Name

Se o produto apresenta uma opção, insira o respectivo nome. Por exemplo, Cor.

A coluna Nome da Opção1 não pode ficar em branco nem estar ausente. Para produtos com somente uma opção, este campo deve ser definido como Title.

Option1 Value

A alteração de informações nessa coluna exclui os IDs de variantes existentes e cria novos IDs de variante. Qualquer alteração nos IDs de variantes pode interromper dependências de terceiros nos IDs de variantes.

Se o produto apresenta uma opção, insira o respectivo valor. Por exemplo, Azul.

A coluna Valor da Opção1 não pode ficar em branco nem estar ausente. Para produtos com somente uma opção, este campo deve ser definido como Default Title.

Option2 Name

Se um produto apresenta uma segunda opção, insira o respectivo nome. Por exemplo, Tamanho.

A coluna Nome da Opção2 pode ficar em branco, mas não pode estar ausente. Se você deixar a coluna em branco e marcar a opção Substituir os produtos atuais que tenham o mesmo identificador. Os valores existentes serão usados para colunas ausentes. ao carregar o arquivo CSV, os nomes da Opção2 serão excluídos.

Option2 Value

A alteração de informações nessa coluna exclui os IDs de variantes existentes e cria novos IDs de variante. Qualquer alteração nos IDs de variantes pode interromper dependências de terceiros nos IDs de variantes.

Se um produto apresenta uma segunda opção, insira o respectivo valor. Por exemplo, Grande.

A coluna Valor da Opção2 pode ficar em branco, mas não pode estar faltando. Se você deixar essa coluna vazia e marcar a opção Substituir os produtos atuais que tenham o mesmo identificador. Os valores existentes serão usados para colunas ausentes. ao carregar o arquivo CSV, os valores da Opção2 serão excluídos.

Option3 Name

Se um produto apresenta uma terceira opção, insira o respectivo nome.

A coluna Nome da Opção3 pode ficar em branco, mas não pode estar ausente. Se você deixar a coluna em branco e marcar a opção Substituir os produtos atuais que tenham o mesmo identificador. Os valores existentes serão usados para colunas ausentes. ao carregar o arquivo CSV, os nomes da Opção3 serão excluídos.

Option3 Value

A alteração de informações nessa coluna exclui os IDs de variantes existentes e cria novos IDs de variante. Qualquer alteração nos IDs de variantes pode interromper dependências de terceiros nos IDs de variantes.

Se o produto apresenta uma terceira opção, insira o respectivo valor.

A coluna Valor da Opção3 pode ficar em branco, mas não pode estar ausente. Se você deixar a coluna em branco e marcar a opção Substituir os produtos atuais que tenham o mesmo identificador. Os valores existentes serão usados para colunas ausentes. ao carregar o arquivo CSV, os valores da Opção3 serão excluídos.

Variant SKU

A SKU do produto ou da variante. Esta informação é usada para acompanhar o estoque por meio de serviços de acompanhamento especializados.

Este campo não pode ficar vazio se você estiver usando um serviço personalizado de processamento de pedidos.

A coluna SKU da variante pode ficar em branco, mas não pode estar ausente. Se você deixar a coluna em branco e marcar a opção Substituir os produtos atuais que tenham o mesmo identificador. Os valores existentes serão usados para colunas ausentes. ao carregar o arquivo CSV, os SKUs da variante serão excluídos.

Variant Grams

O peso do produto ou da variante em gramas. Não especifique uma unidade de medida nem use decimais. Por exemplo, para um peso de 5,125 kg, insira 5125.

A Shopify sempre importa e exporta o peso em gramas, mesmo que você especifique outra unidade. Você precisa inserir o peso exato se pretende oferecer frete calculado por uma transportadora ou utilizar um serviço de processamento terceirizado.

A coluna Gramas da variante não pode estar em branco nem ausente. Ela precisa de um valor, mesmo que seja 0.

Variant Inventory Tracker

Inclua o acompanhamento de estoque para a variante ou o produto. Os valores válidos são shopify, shipwire, amazon_marketplace_web. Deixe em branco se o estoque não tiver acompanhamento.

A coluna Acompanhamento do estoque da variante pode ficar em branco, mas não pode estar ausente. Se você deixar essa coluna vazia e marcar a opção Substituir os produtos atuais que tenham o mesmo identificador. Os valores existentes serão usados para colunas ausentes. ao carregar o arquivo CSV, as opções de acompanhamento de estoque serão excluídas e o estoque não será mais monitorado.

Variant Inventory Qty

O número de itens em estoque do produto ou da variante. Essa coluna é usada somente por lojas da Shopify que tenham um único local.

Se a sua loja gerencia o estoque em vários locais, esta coluna não estará incluída. Se você quiser importar ou exportar os volumes de estoque, utilize o arquivo CSV de estoque.

A coluna Volume de estoque da variante pode ficar em branco, mas não pode estar ausente se a loja tiver somente um local. Se você deixar essa coluna vazia e marcar a opção Substituir os produtos atuais que tenham o mesmo identificador. Os valores existentes serão usados para colunas ausentes. ao carregar o arquivo CSV, o volume de estoque de produtos será excluído.

Variant Inventory Policy

Como manusear os pedidos quando o nível de estoque de um produto ou uma variante chega a zero. Não é possível comprar variantes com uma política de estoque de negar quando o nível de estoque chega a zero. Já as variantes com uma política de estoque de continuar podem ser adquiridas com o nível de estoque em zero, ou seja, é possível trabalhar com valores negativos.

A coluna Política de estoque da variante não pode ficar em branco nem estar ausente.

Variant Fulfillment Service

O serviço de processamento do produto ou da variante que é utilizado. Os valores válidos são manual, shipwire, webgistix ou amazon_marketplace_web.

Se você usa um serviço personalizado de processamento de pedidos, adicione o nome do serviço a esta coluna. Use somente letras minúsculas para o nome personalizado. Não é permitido usar espaços. Substitua por traços (-). Pontos e outros caracteres especiais são removidos. Por exemplo, se o nome de seu serviço de processamento de pedidos for "Depósito da Joana", digite deposito-joana no arquivo CSV.

É preciso ter um serviço personalizado de processamento de pedidos já configurado no admin da Shopify antes de adicionar o nome do serviço nesta coluna.

A coluna Serviço de processamento de pedidos da variante não pode ficar vazia nem estar ausente.

Variant Price

O preço do produto ou da variante. Não inclua símbolos de moeda, insira somente o preço. Por exemplo, 9,99.

A coluna Preço da variante não pode ficar em branco nem estar ausente.

Variant Compare at Price

A "Comparação de preços" do produto ou da variante. Não inclua símbolos de moeda, insira somente o preço. Por exemplo, 9,99.

A coluna Comparação de preços da variante pode ficar em branco, mas não pode estar ausente. Se você deixar a coluna em branco e marcar a opção Substituir os produtos atuais que tenham o mesmo identificador. Os valores existentes serão usados para colunas ausentes. ao carregar o arquivo CSV, a comparação de preços desses produtos será excluída de sua loja da Shopify.

Variant Requires Shipping

A opção para exigir frete. Os valores válidos são TRUE, FALSEou em branco (que é igual a FALSE).

A coluna Variante requer frete pode ficar vazia, mas não pode estar ausente.

Variant Taxable

Aplique impostos a esta variante. Os valores válidos são TRUE, FALSE ou em branco (que é igual a FALSE).

A coluna Variante tributável pode ficar vazia, mas não pode estar ausente.

Variant Barcode

O código de barras, ISBN ou UPC do produto.

A coluna Código de barras da variante pode ficar em branco, mas não pode estar ausente. Se você deixar a coluna em branco e marcar a opção Substituir os produtos atuais que tenham o mesmo identificador. Os valores existentes serão usados para colunas ausentes. ao carregar o arquivo CSV, os códigos de barras desses produtos serão excluídos de sua loja da Shopify.

Image Src

Insira a URL da imagem do produto. A Shopify baixa as imagens durante a importação e faz o recarregamento para sua loja. Essas imagens não são específicas das variantes. Indique isso na coluna Imagem da variante.

Não é possível alterar o nome do arquivo da imagem após o carregamento para a sua loja. Não faça o carregamento de imagens com os sufixos _thumb, _small ou _medium nos nomes.

A coluna Origem da imagem pode ficar em branco, mas não pode estar ausente. Se você deixar a coluna em branco e marcar a opção Substituir os produtos atuais que tenham o mesmo identificador. Os valores existentes serão usados para colunas ausentes. ao carregar o arquivo CSV, as imagens desses produtos serão excluídas de sua loja da Shopify.

Image Position

Insira o número que indica a ordem de exibição da imagem na página do produto. As imagens são exibidas em ordem, da menor para a maior, a começar do valor de posição 1. Por exemplo, insira 1 se você deseja que a imagem seja a primeira a aparecer para aquele produto.

A coluna Posição da imagem pode ficar em branco ou estar ausente. Se você deixar a coluna em branco e marcar a opção Substituir os produtos atuais que tenham o mesmo identificador. Os valores existentes serão usados para colunas ausentes. ao carregar o arquivo CSV, as posições das imagens desses produtos serão excluídas de sua loja da Shopify.

Image Alt Text

O texto alternativo (alt) descreve uma imagem e é uma parte importante da descrição do produto. Se uma imagem não puder ser carregada por qualquer motivo, o texto alternativo será exibido. Ele também é usado pela tecnologia assistiva para descrever uma imagem para um cliente com deficiência visual. Incluir o texto alternativo aumentará a SEO do seu site. Mantenha seu texto alternativo breve e descritivo. O comprimento máximo é de 512 caracteres, mas 125 ou menos é recomendado.

A coluna Texto alternativo de imagem pode ficar vazia, mas não pode estar ausente. Se você deixar essa coluna vazia e marcar a opção Substituir os produtos atuais que tenham o mesmo identificador. Os valores existentes serão usados para colunas ausentes. ao carregar o arquivo CSV, o texto alternativo da imagem desses produtos será excluído de sua loja da Shopify.

Gift Card

Indica se o produto é um cartão-presente ou não. Os valores válidos são TRUE ou FALSE. A inclusão dessa coluna também permite alterar outras informações sobre o cartão-presente, como as colunas "Corpo" ou "Tags", e importar essas alterações. Um cartão-presente só pode ser criado e ativado no admin da Shopify. Não é possível criar um cartão-presente ao importar um arquivo CSV de produtos.

A coluna Cartão-presente pode ficar em branco ou estar ausente. Se você deixar a coluna em branco e marcar a opção Substituir os produtos atuais que tenham o mesmo identificador. Os valores existentes serão usados para colunas ausentes. ao carregar o arquivo CSV, os valores de cartão-presente desses produtos serão excluídos de sua loja da Shopify.

SEO Title

O título de SEO é encontrado na página de informações do produto, no cabeçalho Pré-visualização da listagem do mecanismo de pesquisa, no campo Título da página. O limite para o título de SEO é de 70 caracteres (letras e números). Se você deixar este campo em branco ao importar o produto, ele será preenchido automaticamente com o título do produto.

A coluna Título de SEO não pode ficar em branco nem estar ausente. Se você deixar a coluna em branco e marcar a opção Substituir os produtos atuais que tenham o mesmo identificador. Os valores existentes serão usados para colunas ausentes. ao carregar o arquivo CSV, os títulos de SEO desses produtos serão excluídos de sua loja da Shopify.

SEO Description

A descrição de SEO também pode ser encontrada na página de informações do produto, no cabeçalho Pré-visualização da listagem do mecanismo de pesquisa, no campo Metadescrição. O limite para a descrição de SEO é de 320 caracteres (letras e números). Se você deixar este campo em branco ao importar o produto, ele será preenchido automaticamente com a descrição do produto.

A coluna Descrição de SEO pode ficar em branco ou estar ausente. Se você deixar a coluna em branco e marcar a opção Substituir os produtos atuais que tenham o mesmo identificador. Os valores existentes serão usados para colunas ausentes. ao carregar o arquivo CSV, as descrições de SEO desses produtos serão excluídas de sua loja da Shopify.

Metacampos do Google Shopping

Um app pode usar os campos do Google Shopping para sincronizar produtos com o Google Merchant Center. No entanto, o canal de vendas Google da Shopify não usa esses metacampos. Ignore os campos das colunas com o Google Shopping no nome, a menos que um app diga para usá-los.

A coluna Metacampos do Google Shopping pode ficar em branco ou estar ausente. Se você deixar a coluna em branco e marcar a opção Substituir os produtos atuais que tenham o mesmo identificador. Os valores existentes serão usados para colunas ausentes. ao carregar o arquivo CSV, os metacampos desses produtos serão excluídos de sua loja da Shopify.

Variant Image

A URL das imagens das variantes. Se você adicionar uma URL, ela precisa ser de uma imagem funcional.

A coluna Imagem da variante pode ficar em branco ou estar ausente. Se você deixar a coluna em branco e marcar a opção Substituir os produtos atuais que tenham o mesmo identificador. Os valores existentes serão usados para colunas ausentes. ao carregar o arquivo CSV, as imagens dessas variantes serão excluídas de sua loja da Shopify.

Variant Weight Unit

Os valores válidos são g, kg, lb e oz.

A coluna Unidade de peso da variante pode ficar em branco ou estar ausente. Se esse campo ficar vazio, a Unidade de peso da variante será kg.

Variant Tax Code (Shopify Plus)

O código da Avalara para aplicar a tributação ao produto. Este campo é aplicável somente a importação ou exportação de lojas que usam a integração do Shopify Plus com o AvaTax da Avalara.

Ao criar um arquivo CSV gerado pela exportação de produtos de uma loja que utiliza o AvaTax, o campo Código de tributação da variante é preenchido. Se você importar este arquivo CSV para uma loja que não tem o AvaTax configurado, ocorrerá falha na importação.

A coluna Código de imposto da variante pode ficar em branco ou estar ausente. Se você deixar a coluna em branco e marcar a opção Substituir os produtos atuais que tenham o mesmo identificador. Os valores existentes serão usados para colunas ausentes. ao carregar o arquivo CSV, os códigos de imposto desses produtos serão excluídos de sua loja da Shopify.

Cost per item

O preço de custo do produto ou da variante para você. Não inclua símbolos de moeda, insira somente o custo. Por exemplo, 9,99.

A coluna Custo por item pode ficar em branco ou estar ausente. Se você deixar a coluna em branco e marcar a opção Substituir os produtos atuais que tenham o mesmo identificador. Os valores existentes serão usados para colunas ausentes. ao carregar o arquivo CSV, os custos desses produtos serão excluídos de sua loja da Shopify.

Coluna coleção como exceção

Para organizar produtos em coleções durante o carregamento do arquivo CSV, adicione uma nova coluna com o nome de cabeçalho Collection. Esta é a única coluna que pode ser adicionada ao arquivo CSV sem corromper o formato:

Collection (must create a new column, can be left blank) Insira o nome da coleção em que você quer adicionar o produto. Se for uma coleção automatizada, o produto precisará atender às condições da coleção. Se ela ainda não existir, uma coleção será criada para você. É possível adicionar o produto a somente uma coleção.

Criar seu arquivo CSV de produtos

É preciso decidir se cada produto é simples ou apresenta variantes:

  • Produto simples (não apresenta variantes)

    Ao carregar um produto sem variantes, insira todos os campos (como descrito acima) do produto na primeira linha junto com a URL da primeira imagem. Nas linhas a seguir, insira somente o identificador e a URL de cada imagem adicional.

  • Produto com variantes

    Ao carregar um produto com variantes, insira todos os campos (como descrito acima) do produto na primeira linha junto com a URL da primeira imagem. Nas linhas seguintes, insira o identificador. Em seguida, pule as colunas "Título", "Corpo (HTML)", "Fornecedor" e "Tags". Preencha as informações restantes sobre as variantes e a URL de cada imagem.

Após adicionar os produtos e as imagens, salve o arquivo CSV no formato UTF-8 usando alimentação de linha (LF). Consulte a documentação de seu programa de edição de texto ou planilhas se desconhecer as codificações.

Para visualizar um exemplo de arquivo CSV, baixe esta amostra de arquivo CSV de produtos e abra-o nas Planilhas Google ou em outro programa semelhante.

Preparar suas imagens

Um arquivo CSV só pode conter texto. Portanto, é preciso verificar se todas as imagens dos produtos estão em um site já existente. As URLs das imagens são usadas somente durante o processo de importação do arquivo CSV. Assim, é possível excluí-las após a importação.

  • Se os arquivos estão apenas em seu computador, é preciso carregá-las para sua loja da Shopify ou outro serviço de hospedagem de imagens para vinculá-las a uma URL.

  • Se você está migrando de outra plataforma para a Shopify, é possível copiar as URLs atuais das imagens e usá-las no arquivo CSV.

  • Se o arquivo CSV de produtos foi gerado pela exportação de seus produtos da Shopify, não é preciso fazer mais nada, pois suas imagens já estão em nosso site.

Quando você tiver URLs para cada uma das imagens de produtos, é possível começar a criar seu arquivo CSV.

Adicionar várias imagens de produtos em um arquivo CSV

É possível adicionar mais imagens de produtos a um arquivo CSV. Basta carregar mais imagens no admin da Shopify. Se você está criando uma loja da Shopify com um arquivo CSV, o processo é um pouco diferente. Confira o que é preciso fazer:

  • É preciso saber editar um arquivo CSV. A Shopify recomenda usar o Planilhas Google para visualizar a versão formatada de seus arquivos CSV.

  • É possível adicionar até 250 imagens a um produto.

  • As images dos produtos precisam estar carregadas em uma URL com acesso público. Ou seja, elas precisam estar disponíveis por meio do protocolo https:// sem proteção de senha. Uma opção é carregar as imagens para a página Arquivos do admin da Shopify. As URLS são geradas automaticamente. Após clicar em Carregar arquivos, é possível selecionar cerca de 200 imagens para carregamento em massa.

Para adicionar várias imagens, é preciso:

  1. Inserir novas linhas (uma por imagem).
  2. Copiar e colar o "identificador".
  3. Copiar e colar as URLs das imagens.

Insira novas linhas (uma por imagem)

  1. Abra o arquivo CSV em um programa de planilha eletrônica, como o Planilhas Google.

  2. Localize os produtos aos quais você quer adicionar imagens.

  3. Na próxima linha, clique e arraste os números das linhas para selecioná-las. Selecione o número de linhas que corresponde ao número de imagens adicionais que você incluir.

  4. Enquanto as linhas estiverem em destaque, clique com o botão direito do mouse em qualquer lugar da área destacada e selecione Inserir X linhas acima.

    Com isso, três linhas vazias são criadas abaixo do produto ao qual você deseja adicionar imagens.

Copie e cole o "identificador"

Copie e cole o "identificador" do produto desejado na coluna A das novas linhas.

Copie e cole as URLS das imagens

  1. Carregue suas imagens na Página de arquivos da Shopify.

  2. Em seguida, destaque e copie uma URL de imagem de cada vez.

  3. Retorne ao seu programa de planilha eletrônica e role lateralmente até as colunas finais do arquivo CSV.

  4. Na coluna "Image Src" (abreviação de "Origem da imagem") cole uma URL de imagem em cada linha.

  5. Repita os passos 2 a 4 para todas as imagens deste produto.

  6. (Opcional): preencha os campos da próxima coluna, "Texto alternativo da imagem", para potencializar a SEO. Clique aqui para saber mais sobre o Texto alternativo da imagem.

Em seguida, salve e importe o arquivo para a Shopify.

Pronto para começar a vender com a Shopify?

Experimente de graça