O que costuma dar errado com o Excel em português
| O que você vê | Causa provável |
|---|---|
| A Shopify mostra “Cabeçalho CSV inválido: cabeçalhos ausentes: Title” | Os cabeçalhos estão em português, em minúsculas ou com espaços sobrando |
| Todo o cabeçalho numa única célula, ou colunas deslocadas | O arquivo usa ponto e vírgula em vez de vírgula |
Letras estranhas: Pão, açúcar | O arquivo não foi salvo em UTF-8 |
Preços errados ou rejeitados: R$ 1.299,90 | Símbolo de moeda, ponto de milhar e vírgula decimal |
Cabeçalhos: a Shopify espera os nomes do modelo, em inglês
Mesmo com a Shopify em português, os nomes das colunas do CSV são os do modelo, em inglês. Quando eles não coincidem, a Shopify mostra uma mensagem como: “Houve um erro ao importar o arquivo CSV. Depois de corrigir o problema, tente importar o arquivo CSV novamente. Cabeçalho CSV inválido: cabeçalhos ausentes: Title.” Em uma discussão da Comunidade Shopify em português, a equipe orienta a usar o modelo de CSV da Shopify, conferir que todos os títulos correspondam exatamente e verificar espaços extras.
A tabela mostra nomes comuns em planilhas em português e a coluna da Shopify (modelo clássico) correspondente. São equivalências sugeridas: confirme com o arquivo de exemplo da Shopify.
| Se a sua planilha diz… | Coluna da Shopify | Observações |
|---|---|---|
| Nome, Título, Produto | Title | É a única coluna obrigatória ao criar produtos novos. |
| Identificador, URL, slug | Handle | Letras, números e hífens; um por produto. |
| Descrição | Body (HTML) | Aceita HTML. |
| Marca, Fornecedor, Fabricante | Vendor | |
| Tipo, Categoria (texto livre) | Type | Texto livre; não é a categoria de produto padrão da Shopify. |
| Tags, Etiquetas | Tags | Separadas por vírgulas. |
| Publicado | Published | Valores true ou false. |
| Status | Status | Valores active, draft ou archived. |
| Cor, Tamanho, Variação | Option1 Name e Option1 Value | Name é o nome da opção (Cor); Value é o valor (Azul). |
| SKU, Referência, Código | Variant SKU | |
| Código de barras, EAN | Variant Barcode | A Shopify informa que um arquivo com as colunas Barcode e Barcodes ao mesmo tempo falha: mantenha só uma. |
| Peso | Variant Grams | Número inteiro em gramas, sem unidade. |
| Estoque, Quantidade | Variant Inventory Qty | Número inteiro. |
| Preço, Preço de venda | Variant Price | Número sem símbolo de moeda (1299.90). |
| Preço antigo, Preço “de” | Variant Compare-at Price | Mesmo formato do preço. Escreve-se com hífen, como na lista da Shopify. |
| Imagem, URL da imagem | Image Src | Link público e direto para o arquivo da imagem. |
Preços e números: R$ 1.299,90 vira 1299.90
A Shopify pede o preço apenas como valor monetário, sem símbolo de moeda, com ponto decimal (exemplo da documentação: 9.99). No Brasil é comum escrever ponto de milhar e vírgula decimal, então R$ 1.299,90 precisa virar 1299.90.
| Na planilha | Para a Shopify | Observação |
|---|---|---|
R$ 1.299,90 | 1299.90 | Tira o símbolo e o ponto de milhar; a vírgula vira ponto. |
R$ 49,90 | 49.90 | |
1299,9 | 1299.9 | |
1.299 sem mais contexto | 1299 ou 1.299 | Ambíguo. Confira com a sua lista original. |
Na coluna de peso, a Shopify espera gramas, em número inteiro: 0,5 kg deve ser 500. Na quantidade, use números inteiros.
Para converter na planilha, quando todos os preços da coluna usam ponto de milhar e vírgula decimal, esta fórmula do Excel em português (valor em A2) tira o símbolo, os espaços e os pontos e troca a vírgula por ponto:
=SUBSTITUIR(SUBSTITUIR(SUBSTITUIR(SUBSTITUIR(A2;"R$";"");" ";"");".";"");",";".")
Cole os resultados como valores numa coluna formatada como texto. Não use a fórmula se algum preço já tiver ponto decimal (como 89.90): ela tiraria o ponto e o transformaria em 8990. Teste com poucas linhas e confira o arquivo em um editor de texto.
Acentos: ç, ã, õ, é
Quando um arquivo UTF-8 é lido como Windows-1252 (ou o contrário), as letras acentuadas se desfazem em vários caracteres:
| Deveria aparecer | Aparece assim | Deveria aparecer | Aparece assim |
|---|---|---|---|
| ç | ç | é | é |
| ã | ã | ê | ê |
| õ | õ | á | á |
| ó | ó | ô | ô |
Como exportar corretamente
Os nomes dos menus podem variar conforme a versão e o idioma do programa.
| Programa | O que escolher |
|---|---|
| Excel | Arquivo → Salvar como e, no tipo de arquivo, CSV UTF-8 (delimitado por vírgulas) (*.csv). Atenção: no Excel com configurações regionais brasileiras, o arquivo pode sair com ponto e vírgula mesmo com esse nome, porque o Excel usa o separador de listas do sistema. |
| Planilhas Google | Arquivo → Fazer download → Valores separados por vírgulas (.csv). A Shopify informa que o Google Sheets salva em UTF-8 por padrão. |
| Apple Numbers | Arquivo → Exportar para → CSV… e, em “Codificação de texto”, escolha Unicode (UTF-8). |
Depois de salvar, abra o arquivo num editor de texto (Bloco de Notas, Notepad++ ou VS Code), não no Excel: a primeira linha deve ter as colunas separadas por vírgulas e uma palavra com acento deve aparecer correta.
O que o ShopiClean faz (e não faz) com esse tipo de arquivo
Transparência: o ShopiClean é um produto nosso. Tudo o que está neste guia pode ser feito à mão numa planilha; a ferramenta apenas automatiza as verificações. A análise gratuita e a prévia na tela de até 5 linhas reparadas não têm custo, e baixar o arquivo reparado exige o Passe de 7 dias (US$ 9, pagamento único).
Os testes do ShopiClean citados aqui foram feitos em 21 de outubro de 2026 com arquivos de exemplo.
O que faz:
- Converte arquivos separados por ponto e vírgula ou tabulação em arquivos separados por vírgula e detecta arquivos em Windows-1252, salvando o resultado em UTF-8.
- Tira símbolos de moeda e converte a vírgula decimal: em testes,
R$ 1.299,90virou 1299.90 eR$ 49,90virou 49.90. - Marca valores ambíguos, como
15.990ou120.000, sem alterá-los, para você decidir. - Converte pesos como
0,5 kgem gramas (500) e arredonda quantidades com decimais, informando o que mudou. - Mantém os acentos nos títulos e descrições e, nos handles, troca por letras sem acento (por exemplo
Pão de açúcarvirapao-de-acucar).
O que não faz:
- Não traduz cabeçalhos em português. O Supplier Converter também não os reconhece: ao testar com colunas como Nome e Preço, ele parou e pediu para renomear a coluna do nome para
Title. Renomeie os cabeçalhos manualmente com a tabela acima e depois use o CSV Validator & Fixer. - Não repara texto que já está danificado. Em teste, um arquivo que continha literalmente
Cafésaiu igual, sem aviso. - Não sabe qual convenção numérica a sua planilha usa: valores ambíguos precisam da sua decisão.
- Preço “de”: com o cabeçalho exato do modelo da Shopify,
Variant Compare-at Price, o ShopiClean não limpou os valores dessa coluna em teste (um$12ficou igual). Se você a usa, confira esses valores manualmente.
Fontes e como este guia foi verificado
Os comportamentos da Shopify descritos aqui foram conferidos nas páginas da Central de Ajuda da Shopify listadas abaixo entre 19 e 21 de outubro de 2026. A Shopify pode mudar o sistema de importação; se algo for diferente do que você vê, confie na documentação da Shopify. Páginas marcadas como “em inglês” não têm tradução verificada.
- Central de Ajuda da Shopify: Soluções para problemas comuns de importação de produtos por CSV
- Central de Ajuda da Shopify: Usar arquivos CSV para importar e exportar produtos
- Shopify Help Center: Using CSV files to import and export products (em inglês)
- Comunidade Shopify (em português): exemplo do erro “Cabeçalho CSV inválido: cabeçalhos ausentes: Title”