Shopify 상품 CSV 템플릿 해설
Shopify 공식 상품 CSV 템플릿의 모든 필드를 열별로 설명합니다. 각 열의 역할, 허용되는 값, 필수 열을 알 수 있습니다.
- ✓Shopify 상품 CSV 템플릿의 각 열이 하는 일
- ✓필수 열과 선택 열
- ✓필드 유형별로 허용되는 값과 형식
- ✓상품 수준 열과 변형 수준 열의 차이
- ✓단일 상품과 변형 상품에 맞게 템플릿을 올바르게 채우는 방법
CSV를 고칠 준비가 되셨나요? 업로드하면 바로 검증하고 자동으로 수정합니다.
CSV 수정기 열기템플릿 개요
Shopify 공식 상품 CSV 템플릿의 열은 상품 수준(상품마다 한 번, 첫 행인 상위 행에 입력)과 변형 수준(해당 상품의 모든 행에 입력) 두 종류입니다. 변형이 여러 개인 상품은 같은 Handle을 공유하는 여러 행을 차지합니다.
최신 템플릿은 Shopify 관리자에서 내려받으세요: 제품 → 가져오기 → 샘플 CSV 다운로드.
식별 열
Handle(필수)
Handle은 URL에 쓸 수 있는 상품의 고유 식별자입니다. 다음 조건을 지켜야 합니다.
- 스토어의 모든 상품 중에서 고유해야 합니다
- 영문 소문자, 숫자, 하이픈만 사용해야 합니다
- 처음 가져온 뒤에는 바꾸지 않아야 합니다(Handle을 바꾸면 새 상품 URL이 생깁니다)
예: blue-leather-wallet
같은 상품의 모든 행은 같은 Handle을 써야 합니다. Shopify는 이를 이용해 변형 행을 묶습니다.
Title(상위 행 필수)
스토어에 표시되는 상품명입니다. 상품의 첫 행에 입력하고 변형 행에서는 비워 두세요.
예: Blue Leather Wallet
Body (HTML)
상품 설명입니다. HTML을 넣을 수 있습니다. 설명에 쉼표나 꺾쇠괄호가 있으면 값 전체를 큰따옴표로 감싸세요. 설명 안의 줄바꿈도 따옴표로 감싼 값 안에 있어야 합니다.
Vendor
브랜드나 공급업체 이름입니다. 일반 텍스트입니다.
Type
직접 정하는 상품 유형(정리용)입니다. Shopify 상품 카테고리가 아니라 필터링에 쓰는 자유 텍스트입니다.
Tags
쉼표로 구분한 태그 목록입니다. 태그에 쉼표가 들어 있으면 Tags 셀 값 전체를 따옴표로 감싸야 합니다.
예: "summer, sale, leather"
게시 관련 열
Published(참/거짓)
고객에게 상품을 표시할지 여부입니다. TRUE 또는 FALSE(대문자)를 씁니다.
TRUE: 상품이 활성 상태이며 표시됨FALSE: 상품이 임시 저장 상태(스토어에서 숨겨짐)
Published Scope
상품이 게시되는 곳입니다. 흔히 쓰는 값: web(온라인 스토어), global(모든 채널).
옵션 열
이 열들은 변형의 축(사이즈, 색상, 소재 등)을 정의합니다.
Option1 Name / Option1 Value
Option1 Name은 축의 이름(예: Size, Color)이고, Option1 Value는 각 행의 구체적인 값(예: Small, Medium, Blue)입니다.
규칙:
Option1 Name은 같은 상품의 모든 행에서 같아야 합니다Option1 Value는 변형 행마다 달라집니다- 옵션이 하나뿐이면 Option1만 쓰고, 두 번째나 세 번째 옵션이 없다면 Option2, Option3 열은 넣지 마세요
Option2 Name / Option2 Value(선택)
두 번째 축(예: 색상)입니다. 상품에 축이 두 개일 때만 필요합니다.
Option3 Name / Option3 Value(선택)
세 번째 축입니다. Shopify는 상품당 최대 3개의 옵션을 지원합니다.
변형 열
이 열들은 상위 행과 변형 행을 포함한 모든 행에 적용됩니다.
Variant SKU
해당 변형의 고유 식별자입니다. 선택 사항이지만 재고를 관리한다면 SKU는 고유해야 합니다. SKU 기반 재고 관리를 하지 않으면 비워 두세요.
Variant Price(필수)
해당 변형의 판매 가격입니다. 통화 기호와 천 단위 구분 기호 없이 단순한 소수로 씁니다.
예: 19.99
Variant Compare At Price
취소선으로 표시되는 "정가"입니다. 할인 가격이 없으면 비워 두세요.
Variant Inventory Qty
재고 수량입니다. 정수로 씁니다. 재고가 없으면 0을 쓰세요. 이 변형의 재고 관리를 끈 경우 비워 두세요.
Variant Inventory Policy
재고가 0이 되었을 때의 동작입니다. 허용 값: deny(구매 막기) 또는 continue(재고가 없어도 구매 허용).
Variant Fulfillment Service
변형의 배송 처리 방식입니다. 일반 처리는 manual, 외부 서비스라면 해당 서비스의 API 이름을 씁니다.
Variant Requires Shipping(참/거짓)
배송이 필요한 실물 상품은 TRUE, 디지털 상품은 FALSE입니다.
Variant Taxable(참/거짓)
과세 대상이면 TRUE, 면세면 FALSE입니다.
Variant Barcode
UPC, EAN, ISBN 바코드입니다. 일반 텍스트입니다. Shopify는 검증하지 않고 저장만 합니다.
Variant Weight / Variant Weight Unit
변형의 무게와 단위입니다. 무게는 소수이고, 단위는 kg, g, lb, oz 중 하나입니다.
이미지 열
Image Src
상품 이미지 URL입니다. 공개된 HTTPS URL이어야 합니다. 지원 형식: JPG, JPEG, PNG, GIF, WEBP.
- 상위 행: 상품의 대표 이미지
- 변형 행: 해당 변형의 옵션 조합에 맞는 이미지(예: 파란색 견본)
Image Position
이미지의 표시 순서입니다. 1부터 시작하는 정수이며 대표 이미지는 1이어야 합니다.
Image Alt Text
이미지의 대체 텍스트로, 접근성과 SEO에 쓰입니다.
SEO 열
SEO Title
페이지 제목 태그입니다(브라우저 탭과 검색 결과에 표시). 비워 두면 상품의 Title이 쓰입니다. 70자 미만을 권장합니다.
SEO Description
상품 페이지의 메타 설명입니다. 160자 미만을 권장합니다.
기프트 카드 열
Gift Card(참/거짓)
상품이 기프트 카드일 때만 TRUE입니다. 대부분의 상품은 FALSE이거나 비워 둡니다.
단일 상품과 변형 상품
단일 상품(변형 1개): 상품당 한 행입니다. 필수 열을 모두 채우세요. 옵션 열은 선택 사항입니다.
변형 상품: 상품당 여러 행이며 모두 같은 Handle을 씁니다. 첫 행이 상위 행(Title, Image Src, Body HTML 등 포함)이고, 이후 행은 변형 행입니다(Title은 비어 있으며, Handle 묶음을 통해 상품 수준 데이터를 이어받습니다).
StriveFormats로 자동 수정
Shopify 템플릿을 StriveFormats에 업로드하면 열별로 검증할 수 있습니다. 필수 필드, 참/거짓 형식, 변형 구조, 이미지 URL을 확인한 뒤 바로 가져올 수 있는 깔끔한 파일을 내보냅니다.
CSV를 StriveFormats에 업로드하여 즉각적인 유효성 검사, 자동 수정 및 깔끔한 내보내기를 받으세요.