Shopify CSV 가져오기 뒤 AI 상품 설명이 사라지거나 덮어써질 때 확인하는 법

Shopify 상품 CSV를 가져온 뒤 AI 상품 설명이 사라졌다면 URL handle, Description 열, Overwrite products with matching handles 선택 여부부터 확인하세요. 기존 상품과 같은 핸들을 가진 행을 덮어쓰면서 Description 셀이 비어 있었다면, 저장되어 있던 설명도 빈값으로 바뀔 수 있습니다.

가장 중요한 차이는 열을 빈칸으로 넣는 것과 그 열을 CSV에서 아예 빼는 것입니다. Shopify 공식 안내에 따르면 일치하는 상품을 덮어쓸 때 선택 열이 포함되어 있지만 셀이 비어 있으면 기존 값도 비워지고, 선택 열이 파일에 없으면 그 값은 유지됩니다.

복구 파일을 곧바로 다시 가져오지는 마세요. Shopify 상품 가져오기는 시작한 뒤 취소할 수 없으므로 먼저 현재 상품을 CSV로 내보내 백업하고, 문제가 생긴 상품 한 개만 수정해 시험한 뒤 범위를 늘리는 편이 안전합니다.

먼저 대조할 세 가지

1. 문제가 생긴 행의 URL handle이 기존 상품과 같은지 봅니다.
2. 가져온 파일에 Description 열이 있었는지, 그 셀이 비어 있었는지 확인합니다.
3. 가져오기 화면에서 일치하는 핸들의 상품 덮어쓰기를 선택했는지 확인합니다.

빈칸과 열을 빼는 것은 결과가 다릅니다

CSV에서 빈 셀은 단순히 “이번에는 수정하지 않음”이라는 뜻이 아닐 수 있습니다. 일치하는 핸들의 상품을 덮어쓰도록 선택했다면, 파일에 포함된 열의 빈 셀도 가져올 값으로 처리됩니다. 반대로 Description 열 자체가 없다면 기존 설명은 유지됩니다.

CSV 상태	덮어쓰기 선택	기존 상품 설명 결과
Description 열에 새 문장 있음	선택	새 문장으로 변경
Description 열은 있으나 셀이 빈칸	선택	기존 설명이 빈값으로 바뀔 수 있음
Description 열 자체를 뺌	선택	기존 설명 유지
기존 상품과 같은 URL handle	선택하지 않음	일치하는 기존 상품 행을 가져오지 않음

Shopify 상품 CSV 사용 안내는 일치하는 핸들을 덮어쓸 때 비어 있는 비필수 열은 기존 값을 빈값으로 바꾸고, 파일에서 제외한 비필수 열의 값은 유지된다고 설명합니다. 가격만 바꾸려는 파일이라면 Description 열을 빈칸으로 남겨 두기보다 가져올 필요가 없는 열을 파일에서 제외하는 것이 핵심입니다.

같은 URL handle이 기존 상품을 찾는 기준입니다

URL handle은 상품 주소 끝부분에 쓰이는 값이며, CSV 가져오기에서는 기존 상품과 일치하는지 찾는 기준이 됩니다. 파일 안의 상품명이 비슷해서가 아니라 핸들이 같을 때 기존 상품 덮어쓰기 동작이 적용됩니다.

1. Shopify 관리자에서 문제가 생긴 상품을 엽니다.
2. 검색 엔진 목록이나 상품 URL에서 핸들을 확인합니다.
3. 가져온 CSV의 같은 행에서 URL handle 값을 찾습니다.
4. 두 값이 같다면 그 행의 Description과 다른 포함 열을 모두 대조합니다.
5. 가져오기 당시 덮어쓰기 항목을 선택했는지 작업 기록과 파일로 확인합니다.

덮어쓰기를 선택하지 않았다면 같은 핸들의 기존 상품은 무시됩니다. 이때 새 설명이 반영되지 않은 것은 설명 생성 오류가 아니라 가져오기 범위가 달랐기 때문일 수 있습니다. 관리자에는 설명이 정상인데 상품 페이지에서만 보이지 않는다면 CSV 문제와 분리해 Shopify 상품 설명이 상품 페이지에 안 보일 때 확인할 항목을 점검하세요.

Description과 예전 Body (HTML)을 섞지 마세요

현재 Shopify 상품 CSV 안내와 템플릿은 상품 설명 열을 Description으로 표시합니다. 예전에 내려받은 파일이나 외부 프로그램이 만든 파일에서는 Body (HTML) 같은 이전 열 이름이 남아 있을 수 있습니다. 오래된 파일이 호환되는 경우도 있지만, 열 이름을 추측해 고치기보다 현재 스토어에서 새로 내보낸 파일의 헤더를 기준으로 맞추는 편이 안전합니다.

가져오기 화면에서 열 이름이 정확히 인식되지 않으면 열 매핑을 확인하세요. Description으로 연결해야 할 열이 다른 필드로 연결되거나 가져오지 않는 열로 처리되면 예상한 설명이 들어가지 않습니다. 특히 AI가 만든 문장에 쉼표, 줄바꿈, 따옴표가 있다면 스프레드시트 프로그램에서 파일 형식을 임의로 바꾸지 말고 UTF-8 CSV로 저장합니다.

Shopify의 상품 CSV 오류 해결 안내는 잘못된 헤더가 있을 때 열 매핑을 확인하고, 특수문자 문제에는 UTF-8 인코딩을 사용하도록 안내합니다. 설명이 깨진 글자로 들어갔다면 덮어쓰기 여부뿐 아니라 저장 인코딩도 함께 확인해야 합니다.

되돌리기 전에 현재 상태부터 백업하세요

가져오기 직전의 백업 CSV가 있다면 문제가 생긴 상품 행의 설명을 찾을 수 있습니다. 백업이 없다면 지금 상태라도 먼저 내보내야 가격·재고·옵션 등 현재 정상인 값을 보존할 수 있습니다. Shopify는 CSV 가져오기를 시작한 뒤 취소할 수 없다고 안내하므로, 복구 파일도 범위를 작게 나눠 적용해야 합니다.

1. 현재 상품을 내보냅니다. 문제가 생긴 상품만 선택하거나 필터를 적용해 작은 백업 파일을 만듭니다.
2. 원래 파일과 가져온 파일을 복사본으로 보관합니다. 어떤 행과 열이 달라졌는지 확인할 근거가 됩니다.
3. 상품 한 개의 Description만 복구합니다. URL handle과 Title을 유지하고 불필요한 열은 제외합니다.
4. 한 개 상품으로 시험 가져오기를 합니다. 덮어쓰기 범위와 미리보기 요약을 확인한 뒤 실행합니다.
5. 관리자와 공개 페이지를 각각 확인합니다. 저장된 설명과 구매자에게 보이는 설명이 같은지 봅니다.
6. 정상일 때만 나머지 상품으로 늘립니다. 한 번에 전체 카탈로그를 다시 가져오지 않습니다.

Shopify의 상품 가져오기 안내도 가져오기 전에 상품 데이터를 백업하고, 최근 변경 내용은 스토어 활동 로그에서 확인하도록 권합니다. AIZip(www.aizip.ai.kr)은 CSV 복구 때 문장을 다시 생성하기보다 변경된 행과 열을 먼저 좁혀 확인하는 방식을 권합니다.

정렬과 옵션 열은 설명 밖의 값도 바꿀 수 있습니다

CSV를 스프레드시트에서 정렬하면 상품 행과 이미지 행의 관계가 어긋날 수 있습니다. 상품마다 여러 행이 있는 파일을 일부 열만 기준으로 정렬하면 이미지가 다른 상품과 연결되거나 변형 상품 데이터가 뒤섞일 수 있으므로, 원본 파일의 행 묶음을 유지하세요.

옵션 이름과 옵션 값처럼 서로 의존하는 열도 주의해야 합니다. 설명만 복구하는데 옵션 열까지 포함하면 기존 변형 상품 ID가 바뀌거나 필요하지 않은 값이 덮어써질 수 있습니다. 이번 복구에 필요하지 않은 변형 상품·이미지·가격 열은 빈칸으로 두지 말고 파일에서 제외하는 것이 안전합니다.

복구 파일을 작게 만드는 기준
상품 설명만 되돌린다면 문제가 생긴 상품의 필수 식별 열과 Description을 중심으로 구성하고, 옵션·이미지·가격·재고처럼 이번에 바꾸지 않을 값은 임의로 함께 수정하지 마세요. 가져오기 전 화면에서 인식된 열과 변경 대상 상품 수를 다시 확인합니다.

상품 CSV와 재고 CSV는 역할이 다릅니다

상품 설명은 상품 CSV에서 다룹니다. 재고 수량을 조정하는 inventory CSV에는 상품 설명을 복구하는 역할이 없습니다. 두 파일을 혼동하면 Description 열을 찾을 수 없거나, 의도하지 않게 재고 값만 바뀔 수 있습니다.

복구 뒤 관리자에 설명은 들어왔지만 소재·크기·용도가 빠져 있다면 Shopify AI 상품 설명의 정보 누락을 고치는 법으로 문장 내용을 보완하세요. 번역된 설명만 다른 언어에서 보이지 않는 경우에는 CSV 덮어쓰기와 구분해 시장·언어·번역 필드의 게시 상태를 점검해야 합니다.

가져온 뒤에는 저장값과 공개 화면을 따로 확인합니다

1. 관리자의 상품 Description에 첫 문장과 마지막 문장이 모두 있는지 확인합니다.
2. 변형 상품, 가격, 이미지와 재고가 가져오기 전과 같은지 확인합니다.
3. 상품 Preview를 열어 공개 페이지에 설명이 보이는지 확인합니다.
4. 가져오지 않은 상품까지 바뀌지 않았는지 몇 개를 표본 확인합니다.
5. 스토어 활동 로그와 가져오기 결과 이메일을 보관합니다.

관리자 저장값이 맞는데 공개 페이지에만 예전 문장이 보인다면 더 이상 CSV를 반복해서 가져오지 마세요. 테마가 다른 필드나 공통 텍스트를 불러오는지 확인해야 하며, 검색결과에만 예전 문구가 남은 경우에는 Shopify 상품 설명과 Google 검색결과가 다를 때 확인하는 법처럼 별도의 갱신 범위를 살펴야 합니다.

자주 묻는 질문

Description 셀을 빈칸으로 두는 것과 열을 삭제하는 것은 다른가요?

다릅니다. 일치하는 핸들의 상품을 덮어쓸 때 Description 열이 포함된 빈 셀은 기존 설명을 빈값으로 바꿀 수 있지만, Description 열 자체를 CSV에서 제외하면 기존 설명은 유지됩니다.

덮어쓰기를 선택하지 않으면 같은 URL handle의 상품은 어떻게 되나요?

기존 상품과 핸들이 같은 행은 가져오기에서 무시됩니다. 새 설명을 반영하려면 덮어쓰기가 필요하지만, 적용 전에는 포함된 열과 빈 셀을 모두 확인해야 합니다.

Body (HTML) 열을 Description으로 바꿔야 하나요?

현재 Shopify 템플릿은 Description을 사용하지만 오래된 파일은 이전 열 이름을 포함할 수 있습니다. 임의로 이름만 바꾸지 말고 현재 스토어에서 내보낸 CSV 헤더와 가져오기 화면의 열 매핑을 기준으로 확인하세요.

잘못 시작한 상품 CSV 가져오기를 중간에 취소할 수 있나요?

Shopify 안내상 시작된 상품 CSV 가져오기는 취소할 수 없습니다. 그래서 현재 상품을 먼저 백업하고 한 개 상품으로 시험한 뒤 전체 범위로 늘리는 것이 안전합니다.

재고 CSV로 사라진 상품 설명을 복구할 수 있나요?

아니요. 재고 CSV는 재고 수량 조정용이며 상품 설명은 상품 CSV에서 다룹니다. Description이 포함된 상품 CSV를 사용해 필요한 상품만 복구하세요.