Catalog Precheck
Guias
H001

Shopify CSV “Cabeçalho CSV inválido: cabeçalhos ausentes”: o que verificar

Verifique a primeira linha CSV para obter os nomes exatos da coluna do produto que sua importação precisa. A falta de um cabeçalho Title é uma causa comum, mas as colunas obrigatórias dependem de você criar produtos, atualizá-los ou adicionar variantes.

Definição da regra

A coluna Título necessária está ausente.

Crítico

Limites da correção automática: Esta regra exige revisão manual; os dados comerciais não são alterados automaticamente.

Definição da regra

Está faltando um identificador de URL onde o contexto de atualização ou variante requer um.

CríticoAviso

Limites da correção automática: Esta regra exige revisão manual; os dados comerciais não são alterados automaticamente.

Não cole todas as colunas de um modelo antigo
A página de erro do Shopify mostra uma linha de cabeçalho completa mais antiga. Seu guia de formato CSV do produto atual fornece diferentes colunas mínimas por cenário de importação. Comece com o arquivo real e a operação pretendida.

O que a mensagem aponta

A primeira linha define as colunas. Um cabeçalho com erro ortográfico, espaço em branco extra, delimitador errado ou um cabeçalho copiado de outro tipo de CSV pode impedir que o Shopify reconheça os campos. Verifique a linha real do cabeçalho antes de alterar os dados do produto.

Quais cabeçalhos são necessários?

Crie um produto simples:

Title é a única coluna obrigatória. Um identificador de URL ausente pode ser gerado a partir do título.

Atualizar um produto existente:

Inclua Title e identificador de URL para que Shopify possa identificar o produto.

Adicionar variantes:

Inclui identificador de URL. Ao atualizar colunas relacionadas a variantes, como SKU, preserve também as colunas correspondentes de nome Option1 e valor Option1; omitir dados de opções dependentes pode alterar variantes.

Um cabeçalho Title ausente

Este exemplo de atualização mínima tem nomes de produtos, mas seu primeiro título não é a coluna Title do Shopify.

Inválido: o título Product não é Title
Product title,URL handle
Tee,tee

A pré-verificação do catálogo relata H001 para o cabeçalho Title ausente e avisa que o título Product é desconhecido.

Corrigido: use o título suportado
Title,URL handle
Tee,tee

Somente renomeie a coluna se seus valores realmente forem títulos de produtos. Mantenha uma cópia do arquivo original.

Como consertar o cabeçalho com segurança

  1. 01

    Confirme se este é um produto Shopify CSV, não um inventário ou exportação de outro aplicativo. Abra uma cópia como texto separado por vírgula UTF-8.

  2. 02

    Inspecione a primeira linha, incluindo ortografia e espaços finais. Combine cada título com os dados abaixo dele; não renomeie valores não relacionados apenas para silenciar um erro.

  3. 03

    Escolha criar ou atualizar antes de decidir quais colunas são necessárias. Para atualizações e variantes, mantenha o identificador e quaisquer colunas de opções dependentes.

  4. 04

    Salve um novo CSV, verifique-o localmente e revise a amostra atual do Shopify e as configurações de importação antes de importar.

Verifique o cabeçalho localmente

Escolha o modo de importação pretendido em Catalog Precheck. H001 sinaliza um Title ausente; O H002 verifica quando o identificador de URL é necessário; H003 avisa sobre rumos não reconhecidos. Estas são verificações de arquivos, não uma importação simulada de Shopify. O retorno abre um novo validador; o arquivo selecionado anteriormente não é preservado.
Verifique meu CSVVeja regras de cabeçalho
O que o verificador não pode decidir
Não é possível saber se um título desconhecido pertence a uma integração de aplicativo válida, se uma coluna renomeada contém os dados comerciais corretos ou o que já existe em sua loja. Um relatório limpo não garante o sucesso da importação.

Fontes verificadas: 28 de setembro de 2026. Shopify: problemas comuns de importação · Shopify: formato CSV do produto atual

Catalog Precheck é uma ferramenta independente e não é afiliada ao Shopify.