상품 CSV는 단순한 텍스트 파일이지만 기존 쇼핑몰 상품을 수정할 때는 필수 열이나 변형 옵션 관계가 중요합니다. Shopify 공식 도움말은 새 상품 생성과 기존 상품 업데이트의 필수 열 조건을 구분하며, 옵션 필드를 누락한 일부 업데이트는 기존 변형에 영향을 줄 수 있다고 안내합니다.
이 페이지의 파일은 실제 매장 데이터가 아닌 가상 상품으로 만들었습니다. 예시에는 잘못된 가격 abc, 판매가보다 낮은 비교 가격, 중복 SKU가 포함돼 있습니다. 사이트의 검사기를 직접 실행해 검토 대상이 올바르게 표시되는지 확인할 수 있습니다.
실제 예시 입력과 확인할 결과
예시 파일의 데이터
URL handle,Title,SKU,Option1 name,Option1 value,Price,Compare-at price,... blue-mug,Blue Mug,MUG-001,Color,Blue,15.00,12.00,... blue-mug,,MUG-001,Color,Red,15.00,20.00,... red-cup,Red Cup,CUP-002,Size,M,abc,18.00,... 전체 CSV 열과 값은 아래 예시 파일에 있습니다.
검사 결과 예시
데이터 3행, 상품 핸들 2개 오류 1건 · 주의 2건 주의 · 2행: 비교 가격이 판매가보다 낮음 주의 · 3행: MUG-001 SKU가 2행에도 있음 오류 · 4행: Price 값 abc가 숫자가 아님 Shopify에 실제 업로드하지 않았습니다.
예시 파일 다운로드
이 파일은 가상 상품만 포함합니다. 서버에 개인정보를 보내지 않고 도구를 시험할 수 있습니다.
차근차근 따라 하는 방법
- Shopify에서 상품 전체 내보내기 파일을 백업하세요. 중요 상품은 반드시 원본을 따로 보관합니다.
- 예시 CSV 파일을 내려받아 텍스트로 확인하거나, 엑셀에서 열 때 SKU와 같은 식별자 열을 텍스트 형식으로 지정하세요.
- Shopify CSV 사전 검사기를 열고 기존 상품 업데이트 모드로 바꾼 뒤 예시 파일을 붙여넣거나 선택하세요.
- 로컬 검사 버튼을 누르면 데이터 3행, 상품 핸들 2개, 오류 1건, 주의 2건이 나옵니다. 잘못된 가격 abc는 오류이고 비교 가격·SKU 중복은 검토 경고입니다.
- CSV 보고서를 내려받아 행 번호, 오류 열, 권장 검토 사항을 확인한 뒤 작업용 사본을 수정하세요.
- 실제 가져오기는 Shopify 공식 CSV 규칙을 다시 확인하고 테스트 상품 1~2개로 먼저 수행하세요. 이 도구는 업로드 성공을 보장하지 않습니다.
새 상품 생성과 기존 상품 업데이트는 다릅니다
Shopify 상품 CSV에서 새 단순 상품을 만들 때와 기존 상품을 업데이트할 때 필요한 정보는 다릅니다. 기존 상품 수정에는 URL handle과 Title 열이 중요하며, SKU·재고 등 변형 정보를 바꾸려면 Option1 name과 Option1 value 등의 관계도 확인해야 합니다.
검사기는 생성·업데이트 모드를 따로 제공합니다. 구형 CSV의 Handle, Variant SKU 같은 열도 인식하지만, 같은 의미의 신형·구형 열을 혼용하면 모호해질 수 있어 검사를 거부합니다.
같은 SKU를 발견해도 자동 삭제하지 않습니다
예시의 파란 머그컵은 두 가지 Color 옵션을 갖고 있는데 두 변형 행에 모두 MUG-001이 들어 있습니다. 다른 변형에 실수로 같은 SKU를 사용했는지 확인하도록 주의가 표시됩니다.
같은 SKU가 있다고 Shopify가 반드시 오류로 거부한다는 의미는 아닙니다. 재고 추적 방식과 상품별 식별 정책을 확인한 뒤 수정 여부를 결정하세요. 검사기는 파일을 자동으로 합치거나 삭제하지 않습니다.
가격·재고·이미지를 별도로 점검하세요
Price에 abc처럼 숫자가 아닌 값이 들어가면 도구가 오류로 표시합니다. Compare-at price가 판매가보다 낮으면 의도한 할인 표시인지 확인하도록 주의를 보여 줍니다. 두 항목은 서로 다른 규칙입니다.
이미지 URL의 형식이나 재고 추적 정보도 검토할 수 있지만 원격 이미지의 실제 접근 가능 여부나 Shopify 매장별 재고 위치까지 확인하지는 않습니다. 최신 조건은 공식 Shopify 문서를 참조해야 합니다.
검사를 통과했다고 업로드 성공이 보장되지는 않습니다
도구는 자주 발생하는 오류 가능성만 검사하며 Shopify 실제 가져오기 엔진이 아닙니다. 매장별 마켓 설정, 세금, 카테고리, 앱 필드, 여러 재고 위치 등은 별도 검증이 필요합니다. 파일은 2MB, 최대 2만 행까지 처리합니다.
검사한 뒤 상품 이미지 CSV 병합 도구와 이전·현재 CSV 비교기를 함께 사용하면 실제 변경 내용을 더 안전하게 확인할 수 있습니다. 대량 업로드 전에 원본 백업과 소량 시험을 권장합니다.
자주 묻는 질문
경고가 나오면 Shopify 업로드가 실패하나요?
아니요. 경고는 검토 대상으로 실제 Shopify의 오류와 같지 않습니다. SKU 중복이나 가격 관계가 의도됐을 수도 있습니다.
파일이 서버로 업로드되나요?
아니요. 별도 출처의 브라우저 편집기에서 읽고 검사합니다. Shopify 계정에도 접속하지 않습니다.
CSV 파일을 자동으로 수정하나요?
아니요. 검토 보고서만 내려받습니다. 수정을 적용하기 전에 원본을 백업하고 테스트하세요.
최신 가져오기 기준은 어디에서 볼 수 있나요?
Shopify 공식 도움말의 상품 CSV 형식 안내를 우선 확인하세요.