Shopify 상품을 대량 업로드하는 방법

방법 1: Shopify 관리자에서 상품 CSV 가져오기

Shopify 관리자에서 “Products”로 이동해 “Import”를 선택합니다. Shopify 상품 형식의 CSV를 업로드하고, 핸들이 일치하는 상품을 덮어쓸지 결정한 뒤 미리 보기를 확인하고 확정합니다. Shopify는 파일을 백그라운드에서 처리하고 완료되면 알려 줍니다.

• Shopify의 샘플 상품 CSV 템플릿으로 시작하거나, 기존 상품 하나를 내보내 정확한 열을 확인하세요.
• URL handle 열(이전 템플릿에서는 Handle)이 제품을 식별하며, handle이 같은 행들은 동일 제품의 변형이거나 추가 이미지입니다.
• 주요 열로는 Title, Description(Body (HTML)), Vendor, Product category, Type, Tags, Status, Option1 name / Option1 value, SKU(Variant SKU), Price, Barcodes(Variant Barcode), Product image URL(Image Src)이 있습니다.
• 이미지는 가져오기 시점에 공개 URL에서 불러옵니다.
• 특수 문자가 깨지지 않도록 파일을 UTF-8 CSV로 저장하세요.

변형을 올바르게 처리하기

대부분의 첫 가져오기에서 걸림돌이 되는 것이 변형입니다. 각 상품은 최대 세 가지 옵션(예: 사이즈, 색상, 재질)을 가질 수 있습니다. 상품의 첫 번째 행에는 상품 수준 필드와 옵션 이름이 들어가고, 같은 핸들을 가진 이후의 각 행은 옵션 값, SKU, 가격, 재고를 가진 변형 하나를 추가합니다.

옵션 이름은 모든 행에서 동일하게 유지하고, 각 변형의 옵션 값 조합은 고유해야 각 행이 정확히 하나의 변형에 대응합니다. 변형 열은 있는데 Option1 name과 Option1 value가 없는 행이 있으면 Shopify는 기본 변형을 만들고 기존 변형을 삭제합니다.

방법 2: 대량 가져오기 앱

Shopify App Store의 가져오기 앱은 기본 CSV를 확장합니다. Excel 및 Google Sheets 지원, 메타필드, 공급업체 피드의 예약 가져오기, 다른 플랫폼에서의 마이그레이션 등이 그 예입니다. 반복해서 가져오거나 표준 CSV가 지원하지 않는 필드가 필요하다면 고려해 볼 만합니다.

방법 3: Shopify Admin API

앱과 맞춤형 통합은 CSV 파일 대신 Shopify의 Admin API로 제품을 만들 수 있습니다. 이렇게 하면 스프레드시트를 오가는 과정이 완전히 사라지며, 많은 카탈로그 및 리스팅 도구가 Shopify에서 제품을 만드는 방식입니다.

Doc2Shelf는 이 방식을 사용합니다. OAuth로 스토어를 연결하면, 검토를 마친 리스팅이 이미지, 가격, 카테고리와 함께 초안 제품으로 생성됩니다.

Shopify용 제품 데이터 준비

대량 업로드를 하기 전에 다음을 확인하세요.

• 모든 상품에 고유한 핸들이, 모든 변형에 고유한 SKU가 있습니다.
• 제목이 하나의 패턴(예: 브랜드 + 제품 + 주요 속성)을 따릅니다.
• 설명은 공급업체 텍스트를 붙여 넣은 것이 아니라 직접 작성한 문구이며 단순한 HTML을 사용합니다.
• 사양이 일관된 단위와 이름을 사용하므로 옵션, 태그, 메타필드로 만들 수 있습니다.
• 상품을 먼저 비공개 상태로 가져와서 공개하기 전에 샘플을 검토할 수 있습니다.

제품 데이터가 공급업체 PDF에서 나오는 경우

CSV 가져오기는 이미 깔끔하고 구조화된 데이터가 있다는 전제에서 출발합니다. 공급업체가 사양서와 카탈로그를 PDF로 보내면, 누군가 먼저 제목, 사양, 식별자를 추출하고 설명을 작성해야 하며, 이것이 전체 작업에서 가장 오래 걸리는 부분인 경우가 많습니다.

Doc2Shelf는 이 단계를 대체합니다. 공급업체 PDF를 읽고 검토용 신뢰도 정보와 함께 제품 데이터를 추출하며, Shopify 리스팅 문구 초안을 작성하고, 검토를 마친 제품을 연결된 스토어에 CSV 없이 초안으로 생성합니다.

Shopify 제품 CSV 열: 현재 이름과 이전 이름

Shopify는 제품 CSV의 여러 열 이름을 변경했습니다. 현재 CSV 참조 문서는 URL handle, Description, SKU, Barcodes 같은 이름을 사용하지만, 많은 템플릿과 튜토리얼은 여전히 Handle, Body (HTML), Variant SKU, Image Src를 보여 줍니다. Shopify는 이전 열 이름과의 하위 호환성을 유지한다고 밝히고 있어 이전 파일도 가져올 수 있지만, 새로 내보낸 파일은 현재 이름을 사용하며 두 방식이 섞인 파일은 확인하기 어렵습니다.

이 표는 대부분의 대량 업로드에 필요한 열을 다룹니다. Barcode에서 Barcodes로의 이름 변경은 Shopify 문서에 명시되어 있으며, 나머지 이전 이름은 각 필드가 담는 내용을 기준으로 대응시킨 것이므로 자신의 스토어에서 내보낸 파일과 대조해 확인하세요. 머리글은 대소문자를 구분합니다.

변형과 옵션: 제한 사항과 함정

Shopify 제품에는 최대 3개의 옵션(예: Size, Color, Material)과 최대 2,048개의 변형을 둘 수 있습니다. 변형 한도는 2025년 10월 Shopify가 상향하기 전까지 100개였기 때문에, 그 이전에 작성된 템플릿과 가이드는 여전히 이전 숫자를 인용합니다. 일부 테마, 앱, 판매 채널은 이전 한도를 기준으로 만들어졌으므로, 수백 개의 변형이 있는 제품을 가져오기 전에 사용 중인 것들을 확인하세요.

제품의 첫 번째 행에는 제품 수준 필드와 옵션 이름이 들어갑니다. 같은 URL handle을 가진 이후의 각 행은 옵션 값, SKU, 가격, 무게, 재고를 가진 변형 하나를 추가하며 제품 수준 필드는 비워 둡니다.

업데이트 가져오기에서 놓치기 쉬운 동작이 두 가지 있습니다. 행에 SKU나 무게 같은 변형 열이 있는데 Option1 name과 Option1 value가 빠져 있으면 Shopify는 기본 변형을 만들고 기존 변형을 삭제합니다. 또한 “Grey”를 “Gray”로 바꾸는 것처럼 옵션 값을 변경하면 변형 ID가 삭제되고 새로 생성되므로, 해당 ID를 참조하는 앱과 피드가 깨질 수 있습니다.

Shopify CSV의 제품 이미지

Shopify는 가져오는 동안 Product image URL 열에서 이미지를 다운로드하므로, 각 URL은 공개적으로 접근할 수 있어야 하며 이미지 파일을 직접 가리켜야 합니다. 로그인이 필요한 링크, 미리보기 페이지로 연결되는 링크, 가져오기가 실행되기 전에 만료되는 링크가 이미지가 누락되는 일반적인 원인입니다.

제품에는 이미지나 기타 미디어를 최대 250개까지 둘 수 있습니다. 첫 번째 이미지는 제품의 첫 번째 행에 넣고, 이후 이미지는 각각 같은 URL handle, 이미지 URL, Image position, Image alt text를 가진 별도의 행에 추가하세요. 구매자가 변형을 선택했을 때 특정 이미지를 보여 주려면 해당 변형 행의 Variant image URL에 그 URL을 넣으세요.

대체 텍스트는 최대 512자까지 가능하며 Shopify는 125자 이하를 권장합니다. 제품 제목을 반복하지 말고 이미지에 보이는 내용, 예를 들어 “수위 표시창이 보이는 스테인리스 주전자 정면”처럼 설명하세요.

제품 카테고리, 메타필드, Standard Product Taxonomy

Product category 열은 제품의 주된 기능에 따라 Shopify의 Standard Product Taxonomy에서 카테고리를 지정합니다. Home & Garden > Linens & Bedding > Bedding > Bed Sheets 같은 전체 카테고리 경로나 hg-15-1-2 같은 카테고리 ID 중 하나만 입력하세요. 둘 다 입력하지 마세요. 카테고리가 없는 제품은 미분류로 처리됩니다.

카테고리를 설정하면 해당 카테고리 메타필드를 사용할 수 있으며, 분류 체계에서는 이를 제품 속성이라고 부릅니다. 예를 들어 Shopify의 Shirts 카테고리에는 size, neckline, fabric, color 등 아홉 가지가 있고, 색상 값은 견본으로 표시될 수 있습니다. Option1 LinkedTo 열은 변형 옵션을 이러한 카테고리 메타필드 중 하나에 연결합니다.

카테고리는 탐색 이상의 의미가 있습니다. Shopify Tax가 이를 사용해 세율을 설정합니다. 반면 Type은 직접 정의하는 자유 형식 라벨로, 자체 필터와 보고서에 유용합니다.

사용자 정의 제품 메타필드는 Material (product.metafields.custom.material)처럼 Name (product.metafields.namespace.key) 형식의 머리글이 있는 열로 가져옵니다. 변형 메타필드는 제품 CSV에서 지원되지 않으므로 관리자 화면, 앱 또는 API로 설정하세요.

Shopify CSV 제한과 SEO 필드 길이

Shopify가 제품 CSV 가져오기와 제품 레코드에 대해 문서화한 제한입니다. 이전 가이드에 나오는 숫자, 특히 변형 100개 제한은 최신 정보가 아닙니다.

SEO title과 SEO description 열은 검색 결과에 사용되는 제목과 메타 설명을 채웁니다. 카탈로그 전체에 하나의 패턴을 복사하지 말고 제품별로 작성하세요. 제품명과, 사이즈, 소재, 모델 번호처럼 구매자가 검색하는 속성을 앞에 두세요.

덮어쓰기 또는 생성: 업데이트가 동작하는 방식

제품을 생성하려면 CSV에 Title만 있으면 되며, 변형을 추가하려면 URL handle도 필요합니다. 기존 제품을 업데이트하려면 Shopify에 URL handle과 Title이 필요하고, 가져오기를 시작할 때 handle이 일치하는 제품을 덮어쓸지 선택합니다.

덮어쓰기는 포함한 모든 열에 대해 최종적인 값으로 취급됩니다. 가장 안전한 방식은 내보내기, 수정, 다시 가져오기입니다. 변경하려는 제품을 내보내고, 바꿔야 하는 셀만 수정하고, 옵션 열은 그대로 두고, 덮어쓰기를 켠 상태로 수정한 파일을 가져오세요. 처음부터 열을 최소한으로만 만든 파일은 앞에서 설명한 변형 삭제 동작을 일으키기 쉽습니다.

확인하기 전에 가져오기 미리보기를 읽고, 대규모 업데이트는 먼저 몇 개의 제품으로 실행해 보세요. 수정하기 전에 내보낸 파일이 문제가 생겼을 때 원래대로 되돌리는 수단입니다.

가져오기 전 체크리스트와 문제 해결

대규모 가져오기 전에 다음 단계를 따라 하세요. 이후의 표는 가장 자주 발생하는 문제를 다룹니다.

1. 스토어에서 제품 하나를 내보내 그 머리글 행을 재사용하면 열 이름이 정확히 일치합니다.
2. 모든 제품에 고유한 URL handle을, 모든 변형에 고유한 SKU를 지정합니다.
3. 옵션 이름과 값의 철자가 일관된지 확인하고, 모든 변형 행에 옵션 값이 있는지 확인합니다.
4. Product category에는 분류 체계에서 복사한 카테고리 경로나 ID를 입력합니다.
5. 이미지 URL 일부를 시크릿 브라우저 창에서 열어 로그인 없이 불러와지는지 확인합니다.
6. 첫 실행에서는 Status를 draft로 설정합니다.
7. UTF-8 CSV로 저장하고 파일이 15 MB 미만인지 확인합니다.
8. 제품 5~10개를 가져와 관리자 화면과 스토어 화면에서 검토한 다음 나머지를 가져옵니다.