# CMS: 컬렉션으로 콘텐츠 가져오기

Source: https://support.wix.com/ko/article/%EC%BD%98%ED%85%90%EC%B8%A0-%EA%B4%80%EB%A6%AC%EC%9E%90-%EC%BD%98%ED%85%90%EC%B8%A0%EB%A5%BC-%EC%BB%AC%EB%A0%89%EC%85%98%EC%9C%BC%EB%A1%9C-%EA%B0%80%EC%A0%B8%EC%98%A4%EA%B8%B0 (updated 2026-11-13)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

CSV(쉼표로 구분된 값) 파일에서 CMS(콘텐츠 관리 시스템) 컬렉션으로 콘텐츠를 가져와 시간과 노력을 절약할 수 있습니다. 

  
 이미 모든 정보가 스프레드시트에 저장되어 있거나, 콘텐츠를 [내보낸](https://support.wix.com/ko/article/cms-formerly-content-manager-exporting-content-from-your-collection) 후 스프레드시트 앱에서 변경해 컬렉션으로 다시 가져오려는 경우 특히 유용합니다.

> **중요!** CSV 파일을 새 [카탈로그 컬렉션](https://support.wix.com/ko/article/cms-selling-items-from-catalog-collections)으로 직접 가져올 수는 없습니다. 아이템을 일괄 추가하려면 먼저 CSV 파일을 기본 콘텐츠 컬렉션으로 가져온 후 해당 컬렉션을 카탈로그 컬렉션으로 전환합니다. 전환이 완료되면 해당 카탈로그 컬렉션으로 CSV 파일을 정상적으로 가져올 수 있습니다.

> **참고:**
>
> * Wix 하모니 에디터에서는 컬렉션에 '참조' 및 '문서' 입력란을 추가할 수 있지만, 아직 요소에 연결할 수는 없습니다. [Wix 하모니에서 더 많은 입력란 유형을 연결할 수 있도록 투표하세요](https://support.wix.com/ko/article/wix-harmony-editor-feature-request-using-additional-collection-field-types-2).
> * Wix 하모니 에디터에서는 샌드박스 컬렉션을 사용할 수 없습니다. [Wix 하모니에서 다르게 작동하는 기능에 대해 자세히 알아보세요](https://support.wix.com/ko/article/wix-harmony-whats-new-with-the-cms#features-that-work-differently-in-wix-harmony).

---

## 업로드할 CSV 파일 준비하기

기존 컬렉션으로 가져올 때는 가져오기 후 컬렉션에 유지할 모든 입력란과 값을 포함해야 합니다. 기존 컬렉션의 입력란을 파일의 칼럼에 매핑하지 않으면 해당 입력란의 기존 값이 모두 삭제됩니다. 단, ID, 생성일, 업데이트일, 소유자, 동적 페이지 링크와 같은 시스템 필드는 제외됩니다. 

  
 먼저 [기존 컬렉션을 내보내](https://support.wix.com/ko/article/cms-formerly-content-manager-exporting-content-from-your-collection) 나중에 가져올 데이터에 필요한 입력란과 값이 모두 포함되어 있는지 확인할 수 있습니다.

### 다음 가이드라인에 따라 CSV 파일을 준비합니다.

* 파일의 첫 번째 행은 머리글로 사용됩니다. 첫 번째 행의 각 칼럼은 컬렉션의 입력란으로 가져옵니다.
* 나머지 행은 컬렉션의 아이템으로 가져옵니다. 각 셀의 값은 컬렉션 입력란의 콘텐츠로 가져옵니다.
* 파일에서 입력란을 구분하는 구분 기호로 쉼표를 사용해야 합니다.
* 파일 크기는 1GB를 초과할 수 없습니다.
* 파일에는 아이템을 50,000개까지만 포함할 수 있습니다. 더 많은 아이템을 가져오려면 여러 CSV 파일에 나누어 저장한 후 하나씩 가져옵니다.
* 파일에는 입력란을 총 1,000개까지만 포함할 수 있습니다.

### 파일을 준비할 때 다음 사항도 확인하세요.

* CSV 파일 이름은 컬렉션 이름과 일치하지 않아도 됩니다.
* 컬렉션에 영문자가 아닌 문자가 포함되어 있다면 CSV 파일이 [UTF-8로 인코딩](https://www.fileformat.info/info/unicode/utf8.htm)되었는지 확인하세요.
* 샌드박스 모드가 활성화된 경우 샌드박스 컬렉션을 라이브 컬렉션과 동기화하면 콘텐츠가 라이브 컬렉션에 복사됩니다. [샌드박스 및 라이브 컬렉션 동기화에 대해 자세히 알아보세요](https://support.wix.com/ko/article/cms-about-sandbox-and-live-collections-and-syncing).

### 입력란 유형별 규칙 및 제한 사항:

CMS 컬렉션의 각 입력란 유형에는 서로 다른 유형의 콘텐츠를 저장할 수 있습니다. 가져올 때 콘텐츠의 유효성을 검사하지 않으므로 콘텐츠가 올바른 입력란 유형과 일치하는지 확인하세요.

**ID**

아이템 ID가 포함된 CSV 파일에서 콘텐츠를 가져와 컬렉션의 기존 아이템을 업데이트할 수 있습니다. 정확하게 업데이트하려면 기존 컬렉션의 콘텐츠를[내보낼 때 ID 입력란을 포함](https://support.wix.com/ko/article/cms-formerly-content-manager-exporting-content-from-your-collection)하는 것이 가장 간단합니다.

![A screenshot of the Configure Columns to Import window with the ID column selected and the Action for Matching IDs options.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/04/05/df534b73-7631-413f-a9bc-7641a9c99141/42934f59-8d85-4f70-a837-700b1ce52dc8.png)

파일을 가져올 때 다음 사항을 참고하세요.

* 기존 컬렉션에 동일한 ID의 아이템이 이미 있는 경우, ID를 교체하거나 ID가 일치하는 아이템을 건너뛸 수 있습니다.
* 기존 컬렉션에 동일한 ID의 아이템이 없는 경우, 해당 행은 CSV 파일에 기재된 ID를 사용하는 새 아이템으로 추가됩니다.

**불리언 입력란**

불리언 입력란으로 콘텐츠를 가져오려면 CSV 파일에서 참 및 거짓 값을 표시하는 형식을 정의해야 합니다.

아래 예시에서 CSV 파일의 값은**예** 및**아니요**입니다. 가져온 결과는**가져오기 후 예시** 칼럼에서 확인할 수 있습니다.

![A screenshot of the Configure Columns to Import window with the True and False values in the file set to Yes and No.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/9fece466-836a-4dbb-b473-f21bfa85fc71/2019/04/07/a4b2f2ae-df8d-4d31-bec3-9e7ec79a7d03/68532441-1665-45b9-9bc4-7408af467ea1.png)

**날짜 및 시간 입력란**

날짜 및 시간 입력란으로 콘텐츠를 가져오려면 CSV 파일의 날짜 형식을 정의해야 합니다.

**참고:**

* 이 설정은 컬렉션에 날짜가 표시되는 방식에 영향을 주지 않습니다.
* 라이브 사이트에 [표시되는 날짜 및 시간의 형식을 지정하는 방법에 대해 자세히 알아보세요](https://support.wix.com/ko/article/cms-formatting-live-site-date-and-time-content-from-your-collection).
![A screenshot of the Configure Columns to Import window with the Date Format in File drop-down set to DD/MM/YYYY.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/9fece466-836a-4dbb-b473-f21bfa85fc71/2019/04/07/f72d88d8-b138-462f-af5b-d4948ce6e68e/3e6a1855-1479-45ba-9aca-64fb6866d829.png)
* 내보낸 CSV 파일의 시간 입력란은 UTC+0을 기준으로 표시됩니다. 컬렉션의 시간 입력란에는 현재 시간대로 변환된 시간이 표시됩니다.
![A screenshot of a CMS collection with a value in the Time field selected.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/f0656688-8ed1-488a-888d-62373b7c3a3c/2021/02/02/f244cef0-23ef-41ee-8da3-4b06a0d2254c/b9c02de4-46d0-47e4-b1f7-3543ba853ead.png)

**참조 입력란**

참조 입력란을 가져오면 참조된 아이템의 [ID 시스템 필드](https://support.wix.com/ko/article/cms-formerly-content-manager-about-your-collection-fields#system-fields)가 입력란 값으로 저장됩니다. [참조 입력란](https://support.wix.com/ko/article/adding-a-reference-field-to-a-cms-collection)에 대해 자세히 알아보세요.

**예외**

다음을 제외한 모든 지원 입력란 유형을 컬렉션으로 가져올 수 있습니다. 

* 동적 페이지에 연결되는 입력란입니다.
* ID 입력란을 제외한 [시스템 필드](https://support.wix.com/ko/article/cms-formerly-content-manager-about-your-collection-fields#system-fields)입니다.
* 미디어 매니저에 이미 있는 문서에 연결되지 않은 문서 입력란입니다.
* 미디어 매니저에 이미 있는 이미지에 연결되지 않은 이미지 입력란입니다.

---

## CSV 파일에서 컬렉션 콘텐츠 가져오기

CSV 파일 준비가 완료되면 콘텐츠를 가져올 컬렉션으로 이동합니다. 각 칼럼을 새 입력란으로 가져오거나 기존 입력란을 교체할 수 있습니다. 기본적으로 컬렉션의 기존 입력란과 이름 또는 키가 같은 칼럼은 서로 매핑됩니다.

> **CSV 파일을 가져오면 기존 컬렉션의 값을 덮어씁니다.**
>
> * 칼럼을 기존 입력란에 매핑하지 않으면 가져오기가 완료될 때 해당 입력란의 모든 값이 삭제됩니다. 단, ID, 생성일, 업데이트일, 소유자, 동적 페이지 링크와 같은 시스템 필드에는 적용되지 않습니다.
> * 가져오지 않을 칼럼의 체크상자를 선택 해제했으며 컬렉션에 같은 이름의 입력란이 있는 경우, 다른 칼럼을 해당 입력란에 매핑하지 않으면 기존 값이 삭제됩니다. 단, 시스템 필드에는 적용되지 않습니다.

### CSV 파일을 업로드하려면 다음 단계를 따르세요.

1. 사이트 대시보드에서 [CMS](https://www.wix.com/my-account/site-selector/?buttonText=Go%20to%20CMS&title=Select%20a%20Site&autoSelectOnSingleSite=true&actionUrl=https://www.wix.com/dashboard/%7B%7BmetaSiteId%7D%7D/database/)로 이동합니다.
2. 해당 컬렉션에서 **추가 작업** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/07/12/ae59c5da-fd96-4f93-b553-f177ecdaf370/ee1ef2ef-0572-4f72-9828-7ef96320285e.png) 아이콘을 클릭한 후 **컬렉션에 아이템 가져오기**를 선택합니다.  
**참고:** 아직 CMS 컬렉션을 생성하지 않았다면 **컬렉션 생성**을 클릭하고 **CSV에서 가져오기**를 선택한 후 **다음**을 클릭합니다.

![컬렉션의 추가 작업 메뉴에서 컬렉션에 아이템 가져오기를 선택한 CMS 페이지의 스크린샷입니다.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/07/12/997d3e71-6972-4e33-9dbb-476325bd6ae6/ceb60bad-891d-4bb6-88b7-2bf542b14313.png)

1. **파일 선택**을 클릭합니다.
2. 컴퓨터에서 CSV 파일을 선택한 후 **열기**를 클릭합니다.
3. 왼쪽에서 가져온 각 칼럼을 컬렉션의 새 입력란 또는 기존 입력란에 매핑합니다. 각 칼럼에 적용할 작업을 선택합니다.  
   1. 칼럼을 새 입력란 또는 기존 입력란으로 가져오려면 체크상자를 선택합니다. 칼럼을 가져오지 않으려면 체크상자를 선택 해제합니다.  
   2. **칼럼 설정** 드롭다운을 클릭한 후 옵션을 선택합니다.

**기존 입력란**

해당 칼럼과 값으로 컬렉션의 기존 입력란을 덮어씁니다.

1. **컬렉션 입력란에 매핑** 드롭다운을 클릭하고 덮어쓸 기존 입력란을 선택합니다. 오른쪽에서 가져오기 후 콘텐츠가 어떻게 표시되는지 예시를 확인할 수 있습니다.  
![A screenshot of the Configure Columns to Import window with the Title column mapped to the existing Title field.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/04/05/810d897e-1608-4abf-8f6b-bb9a497610a0/dd08079a-4222-4946-9e83-a5b2779bcb00.png)  
**참고:** 칼럼의 데이터 유형을 지원하지 않는 입력란 유형을 선택하면 오른쪽의 **가져오기 후 예시**가 빨간색으로 표시됩니다. 이 경우 다른 [입력란 유형](https://support.wix.com/ko/article/cms-formerly-content-manager-supported-content-in-collection-field-types)을 선택해야 합니다.
2. 필요한 경우 입력란 유형에 따라 제공되는 추가 맵핑 옵션을 설정합니다.
3. 기존 입력란을 덮어쓸 각 칼럼에 이 단계를 반복합니다.
4. **다음**을 클릭합니다.
5. 테이블을 검토해 CSV 파일의 칼럼이 컬렉션 입력란에 올바르게 매핑되었는지 확인합니다. 매핑을 조정하려면 **뒤로**를 클릭합니다.
6. 파일을 컬렉션으로 가져올 준비가 되면 **가져오기**를 클릭합니다.  
![A screenshot of the Review File Import window showing how each column maps to an existing field, with the Import button.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/04/05/5210e79c-dbe0-4c24-aa27-f0d02c3e1625/e90ba293-0873-4761-a515-fa5ed152afb3.png)

**새 입력란**

해당 칼럼과 값이 컬렉션의 새 입력란으로 추가됩니다.

1. **입력란 이름**을 입력합니다.
2. 새 컬렉션 입력란의 **입력란 유형**을 선택합니다. 오른쪽에서 가져오기 후 콘텐츠가 어떻게 표시되는지 예시를 확인할 수 있습니다.  
**참고:** 칼럼의 데이터 유형을 지원하지 않는 입력란 유형을 선택하면 오른쪽의 **가져오기 후 예시**가 빨간색으로 표시됩니다. 이 경우 다른 [입력란 유형](https://support.wix.com/ko/article/cms-formerly-content-manager-supported-content-in-collection-field-types)을 선택해야 합니다.
3. 새 컬렉션 입력란으로 가져올 각 칼럼에 이 단계를 반복합니다.
4. **다음**을 클릭합니다.
5. 테이블을 검토해 CSV 파일의 칼럼이 컬렉션 입력란에 올바르게 매핑되었는지 확인합니다. 매핑을 조정하려면 **뒤로**를 클릭합니다.
6. 파일을 컬렉션으로 가져올 준비가 되면 **가져오기**를 클릭합니다.  
![A screenshot of the Review File Import window showing new URL fields in the list, with the Import button.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/04/05/91a926ff-a137-4464-93e0-812ec89efb68/ef726de5-ca2a-4b82-b1d6-16739d37eaf6.png)

> **실수했나요?** 파일을 컬렉션으로 가져오면 배경에서 백업이 생성됩니다. 이 과정에서 컬렉션의 자동 백업을 덮어쓰지 않습니다. 대신 가져오기 전 버전으로 [컬렉션을 복원](https://support.wix.com/ko/article/cms-formerly-content-manager-backing-up-your-collections)할 수 있는 수동 백업이 생성됩니다.

---

## 기존 아이템 업데이트 시 샌드박스 컬렉션 사용하기

샌드박스 기능을 사용 중이라면 CSV 파일을 가져온 후 [샌드박스 콘텐츠를 라이브 컬렉션에 동기화](https://support.wix.com/ko/article/cms-accessing-and-syncing-your-sandbox-and-live-collections#accessing-and-syncing-sandbox-and-live-collections)해야 합니다. 

  
 샌드박스를 활성화하면 에디터에서 샌드박스 컬렉션으로 콘텐츠를 직접 가져올 수 있습니다. 가져오는 동안 [컬렉션 구조](https://support.wix.com/ko/article/cms-about-the-structure-of-your-collection)에 새 입력란을 추가할 수도 있습니다. 즉, 컬렉션에 아직 없는 칼럼도 CSV 파일에 포함할 수 있습니다.
