가이드
V001

Shopify CSV "검증 실패: 옵션이 고유하지 않습니다": 수정 방법

하나의 제품 핸들 아래에서 동일한 Option1–3 값 조합이 있는 두 개의 변형 행을 찾으십시오. 반복되는 모든 핸들을 변경하지 마십시오. 한 제품의 변형은 일반적으로 이를 공유합니다.

규칙 정의

하나의 핸들 아래 변형이 동일한 옵션 조합을 반복합니다.

치명적

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

새로운 옵션 값을 만들어내지 마세요.
이 CSV가 기존 제품을 업데이트하는 경우 옵션 값을 변경하면 새로운 변형 ID가 생성되고 이에 의존하는 앱에 영향을 미칠 수 있습니다. 편집하기 전에 매장에서 원하는 변형을 확인하세요.

오류의 의미

Shopify는 파일에 한 제품에 대한 중복 옵션이 포함되어 있거나 동일한 제품이 동일한 핸들 아래 다른 곳에 나타날 수 있다고 말합니다. 하나의 크기 또는 색상 셀이 아닌 전체 옵션 조합을 비교하십시오. 정품 변형 행에는 반복되는 핸들이 예상됩니다.

행 2개, 크기 값 1개

아래 두 행 모두 핸들 티에 속하며 크기: M 옵션 조합으로 결정됩니다. 좁은 화면에서 코드 블록을 옆으로 스크롤하면 모든 열을 볼 수 있습니다.

유효하지 않음: 중복된 옵션 조합
Title,URL handle,Option1 name,Option1 value
Tee,tee,Size,M
,tee,,M

규칙 V001는 두 비즈니스 행에 플래그를 지정합니다. 연속 행의 공백 Title 및 Option1 이름은 M을 다른 변형으로 만들지 않습니다.

예시 수정: 두 가지 크기
Title,URL handle,Option1 name,Option1 value
Tee,tee,Size,M
,tee,,L

두 번째 행이 실제로 크기 L을 설명하는 경우에만 L을 사용하세요. 그렇지 않으면 원본 데이터를 확인한 후 실제로 중복된 행을 제거하거나 제품 매핑을 수정하세요.

안전하게 조사하는 방법

  1. 01

    원본 CSV를 유지하세요. URL 핸들별로 행을 그룹화한 다음 각 제품 내의 비어 있지 않은 모든 Option1, Option2 및 Option3 값을 비교합니다.

  2. 02

    반복되는 행이 의도한 개별 변형인지, 실수로 중복된 제품 행인지, 이미지 전용 연속 행인지 확인하세요. 반복되는 핸들만으로는 제품 이름을 바꾸는 이유가 되지 않습니다.

  3. 03

    실제 소스 실수를 수정합니다. 실제 변형에 실제 옵션 값을 제공하고, 확인된 중복만 제거하거나, 다른 제품에 속하는 경우 오른쪽 핸들을 사용합니다.

  4. 04

    로컬 검사를 다시 실행하고, 다른 결과를 검토하고, 가져오기 전에 Shopify의 기존 변형에 대한 변경 사항을 확인하세요.

로컬에서 중복 조합 찾기

카탈로그 사전 확인 규칙 V001는 동일한 핸들 아래에서 비어 있지 않은 Option1–3 조합을 반복적으로 보고합니다. 이미지 전용 행은 무시됩니다. 어떤 행이 올바른지 결정하거나 이미 매장에 있는 변형을 볼 수는 없습니다. 돌아오면 새로운 유효성 검사기가 열립니다. 이전에 선택한 파일은 보존되지 않습니다.
무엇이 불확실한가
깨끗한 파일 수준 스캔은 CSV가 기존 Shopify 변형과 일치하거나 가져오기가 성공한다는 것을 증명하지 않습니다. 기존 제품의 옵션을 변경하기 전에 의도한 제품 및 변형 ID를 검토하세요.

확인된 출처: 2026년 9월 28일. Shopify: 일반적인 가져오기 문제 · Shopify: 제품 CSV 옵션 및 변형 ID

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