가이드
H001

Shopify CSV “잘못된 CSV 헤더: 헤더 누락”: 확인 사항

가져오기에 필요한 정확한 제품 열 이름은 첫 번째 CSV 행을 확인하세요. Title 헤더 누락이 일반적인 원인이지만 필수 열은 제품 생성, 업데이트 또는 변형 추가 여부에 따라 달라집니다.

규칙 정의

필수 제목 열이 없습니다.

치명적

자동 수정 범위: 이 규칙은 수동 검토가 필요하며 업무 데이터는 자동으로 변경되지 않습니다.

규칙 정의

업데이트 또는 변형 컨텍스트에 URL 핸들이 필요하지만 없습니다.

치명적경고

자동 수정 범위: 이 규칙은 수동 검토가 필요하며 업무 데이터는 자동으로 변경되지 않습니다.

이전 템플릿의 모든 열을 붙여넣지 마세요.
Shopify의 오류 페이지에는 이전 전체 헤더 행이 표시됩니다. 현재 제품 CSV 형식 가이드는 가져오기 시나리오에 따라 서로 다른 최소 열을 제공합니다. 실제 파일과 의도한 작업부터 시작하세요.

메시지가 가리키는 내용

첫 번째 행은 열을 정의합니다. 철자가 틀린 제목, 추가 공백, 잘못된 구분 기호 또는 다른 CSV 유형에서 복사된 헤더로 인해 Shopify가 필드를 인식하지 못할 수 있습니다. 제품 데이터를 변경하기 전에 실제 헤더 행을 확인하세요.

어떤 헤더가 필요합니까?

간단한 제품을 만듭니다.

Title는 유일한 필수 열입니다. 제목에서 부재 URL 핸들이 생성될 수 있습니다.

기존 제품 업데이트:

Shopify가 제품을 식별할 수 있도록 Title와 URL 핸들을 모두 포함합니다.

변형 추가:

URL 핸들을 포함합니다. SKU와 같은 변형 관련 열을 업데이트할 때 일치하는 Option1 이름 및 Option1 값 열도 유지하십시오. 종속 옵션 데이터를 생략하면 변형이 변경될 수 있습니다.

Title 헤더 누락

이 최소 업데이트 예에는 제품 이름이 있지만 첫 번째 제목은 Shopify의 Title 열이 아닙니다.

유효하지 않음: Product 제목이 Title가 아닙니다.
Product title,URL handle
Tee,tee

카탈로그 사전 확인은 누락된 Title 헤더에 대해 H001를 보고하고 Product 제목을 알 수 없다고 경고합니다.

수정됨: 지원되는 제목을 사용하세요.
Title,URL handle
Tee,tee

해당 값이 실제로 제품 제목인 경우에만 열 이름을 바꾸십시오. 원본 파일의 복사본을 보관하세요.

헤더를 안전하게 고정하는 방법

  1. 01

    인벤토리나 다른 앱의 내보내기가 아닌 Shopify 제품 CSV인지 확인하세요. UTF-8 쉼표로 구분된 텍스트로 사본을 엽니다.

  2. 02

    철자와 후행 공백을 포함하여 첫 번째 행을 검사합니다. 각 제목을 그 아래의 데이터와 연결하세요. 단지 오류를 없애기 위해 관련 없는 값의 이름을 바꾸지 마십시오.

  3. 03

    필요한 열을 결정하기 전에 생성 또는 업데이트를 선택하십시오. 업데이트 및 변형의 경우 핸들 및 종속 옵션 열을 유지합니다.

  4. 04

    새 CSV를 저장하고 로컬로 확인한 다음 가져오기 전에 Shopify의 현재 샘플과 가져오기 설정을 검토하세요.

로컬에서 헤더를 확인하세요.

카탈로그 사전 확인에서 원하는 가져오기 모드를 선택합니다. H001는 누락된 Title에 플래그를 지정합니다. H002는 URL 핸들이 필요한 시기를 확인합니다. H003는 인식할 수 없는 제목에 대해 경고합니다. 이는 시뮬레이션된 Shopify 가져오기가 아닌 파일 검사입니다. 돌아오면 새로운 유효성 검사기가 열립니다. 이전에 선택한 파일은 보존되지 않습니다.
체커가 결정할 수 없는 것
알 수 없는 제목이 유효한 앱 통합에 속하는지, 이름이 변경된 열에 올바른 비즈니스 데이터가 포함되어 있는지 또는 스토어에 이미 존재하는 항목이 있는지 알 수 없습니다. 깨끗한 보고서가 가져오기 성공을 보장하지는 않습니다.

확인된 출처: 2026년 9월 28일. Shopify: 일반적인 가져오기 문제 · Shopify: 현재 제품 CSV 형식

카탈로그 사전 확인은 독립적인 도구이며 Shopify와 관련이 없습니다.