# 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%BB%AC%EB%A0%89%EC%85%98-%EC%9E%85%EB%A0%A5%EB%9E%80-%EC%A0%95%EB%B3%B4 (updated 2026-11-12)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

CMS(콘텐츠 관리 시스템) 컬렉션 입력란에는 컬렉션의 각 아이템에 대한 콘텐츠가 저장됩니다. 입력란 유형에 따라 저장할 수 있는 콘텐츠의 종류와 입력란에 연결할 수 있는 사이트 요소가 결정됩니다. 

  
 테이블 컬렉션 레이아웃에서는 입력란이 세로 칼럼으로 표시됩니다. 각 칼럼 상단에는 입력란 이름이, 셀에는 각 아이템의 콘텐츠가 표시됩니다. 목록 또는 갤러리 레이아웃에서도 컬렉션 입력란을 관리할 수 있습니다.

![CMS 컬렉션 입력란을 관리하는 화면입니다.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/11/9df66c90-da63-4fd1-ad63-c30a478b62e2/06e482b1-623b-4ea6-873d-3a3b3ceaf28d.png)

---

## 기본 입력란

모든 컬렉션에는 기본 입력란이 있어야 하며, 입력란 이름 옆의 **플래그** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/11/0d290cd0-aacb-45a5-b368-8ca1671d416f/87ed1662-8a50-4dab-b13d-1bbce8681d94.png) 아이콘으로 확인할 수 있습니다. 기본적으로 각 컬렉션에는 '제목'이라는 기본 입력란이 포함됩니다. 각 아이템의 기본 입력란에 고유한 값을 입력하는 것이 좋습니다. 

  
 기본 입력란은 [동적 아이템 페이지 URL](https://support.wix.com/ko/article/cms-creating-unique-dynamic-page-urls)에 사용되므로 매우 중요합니다. 동적 아이템 페이지를 생성할 각 아이템의 기본 입력란에 고유한 콘텐츠를 추가하세요. 기본 입력란에 콘텐츠가 없으면 해당 아이템의 동적 아이템 페이지 URL을 생성할 수 없습니다. 컬렉션에서 기본 입력란이 동적 아이템 페이지와 연결된 페이지 링크 입력란에 어떻게 추가되는지 확인할 수 있습니다.

![동적 아이템 페이지의 기본 입력란과 페이지 링크 입력란을 보여주는 화면입니다.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/11/caaa4ea3-edb3-4627-b217-9c08bae8b98a/f37b92dd-ec1d-4000-9111-6cd0f64533f1.png)

> **참고:** Wix 하모니 에디터로 제작한 사이트에서는 각 아이템 페이지 URL이 **아이템 슬러그** 입력란의 슬러그로 끝납니다. [Wix 하모니의 아이템 페이지 URL에 대해 자세히 알아보세요](https://support.wix.com/ko/article/wix-harmony-editor-whats-new-with-item-pages#item-page-urls).

기본 입력란은 [참조 입력란](https://support.wix.com/ko/article/cms-using-reference-fields-to-display-content-from-multiple-collections)에서도 중요합니다. 참조 입력란을 추가할 때는 참조할 컬렉션의 기본 입력란에 있는 값 중에서 선택합니다. 참조할 컬렉션의 기본 입력란을 변경하면 참조 입력란에 표시되는 값도 새 기본 입력란의 값에 맞게 변경됩니다.

---

## 일반 입력란

컬렉션에 입력란을 추가할 때 다양한 입력란 유형 중에서 선택할 수 있습니다. 각 입력란에는 입력란 유형, 입력란 이름, 입력란 ID, 도움말 텍스트(선택사항)가 포함되며, 입력란 콘텐츠를 개인 식별 정보(PII)로 암호화할 수도 있습니다. 

  
 또한, [입력란 유효성 검사를 설정](https://support.wix.com/ko/article/cms-setting-field-validations-in-your-collections)해 특정 입력란을 필수로 지정하거나 글자 수를 제한하고, 지정된 값만 허용하는 등의 설정을 적용할 수 있습니다. 새 아이템을 추가할 때 입력란이 비어 있지 않도록 자동으로 입력되는 [기본값을 추가](https://support.wix.com/ko/article/cms-adding-default-values-to-fields-in-your-collections)할 수도 있습니다.

### 입력란 유형

입력란 유형에 따라 해당 입력란에 [저장할 수 있는 콘텐츠의 종류](https://support.wix.com/ko/article/cms-formerly-content-manager-supported-content-in-collection-field-types)와 [연결할 수 있는 사이트 요소](https://support.wix.com/ko/article/cms-formerly-content-manager-elements-and-the-collection-fields-they-can-connect-to)가 결정됩니다. 예를 들어 다중 문서 입력란에는 문서 파일만 저장할 수 있으며, 방문자가 컬렉션에 파일을 업로드할 수 있도록 하는 [입력 요소](https://support.wix.com/ko/article/cms-about-user-input-elements)인 업로드 버튼에 연결됩니다. 

  
 저장하는 콘텐츠의 종류를 변경하려면 [기존 입력란의 입력란 유형을 변경](https://support.wix.com/ko/article/cms-formerly-content-manager-changing-a-field-type-in-a-collection)할 수 있습니다. 입력란이 사이트에 연결되어 있다면 유형을 변경할 때 링크가 작동하지 않는 등의 문제가 발생할 수 있습니다. 또한, ['기본' 입력란](https://support.wix.com/ko/article/cms-formerly-content-manager-about-your-collection-fields#primary-fields), ['시스템' 입력란](https://support.wix.com/ko/article/cms-formerly-content-manager-about-your-collection-fields#system-fields) 또는 [Wix 다국어의 번역 매니저에 추가된 컬렉션](https://support.wix.com/ko/article/wix-multilingual-translating-cms-collection-content)의 입력란은 유형을 변경할 수 없습니다.

> **참고:** Wix 하모니 에디터로 제작한 사이트에서는 입력란 유형을 변경할 수 없습니다. 대신 필요한 유형의 [새 입력란을 추가](https://support.wix.com/ko/article/cms-formerly-content-manager-adding-a-field-to-a-collection)한 후 콘텐츠를 복사하세요.

**각 입력란 유형에는 어떤 콘텐츠를 저장할 수 있나요?**

선택한 입력란 유형에 따라 입력란에 저장할 수 있는 콘텐츠가 달라집니다. 다음 CMS 입력란 유형 중에서 선택할 수 있습니다.

* **에센셜:**  
   * **텍스트:** 제목, 설명 등 텍스트 기반 콘텐츠에 사용할 일반 텍스트를 저장합니다.  
   * **서식있는 텍스트:** CMS에서 포맷팅 옵션을 사용해 텍스트를 직접 추가하고 관리합니다.  
   * **리치 콘텐츠:** CMS에서 서식있는 텍스트, 미디어 삽입 및 기타 고급 기능을 활용해 콘텐츠를 직접 추가하고 관리합니다.  
   * **URL:** 하이퍼링크 및 탐색 링크를 만드는 데 사용할 웹 주소를 저장합니다. 지원되는 형식은 **http://**, **https://**, **ftp://**, **mailto:**, **sms:**, **tel:**  
   **참고:** 웹 주소는 **http://** 또는 **https://** 형식이어야 합니다. **www.**로 시작하는 주소는 자동으로 **http://** 형식으로 전환됩니다.  
   * **이메일:** 이메일 주소를 저장합니다. 링크가 올바르게 작동하도록 주소가 유효한 형식인지 확인합니다. 버튼에 연결하면 방문자가 클릭 한 번으로 이메일을 보낼 수 있습니다.  
   * **숫자:** 수량, 가격, 크기 등 다양한 용도로 사용할 숫자 데이터를 저장합니다.  
   * **불리언:** 컬렉션 입력란에 체크박스로 표시되는 이진 값인 'true' 또는 'false'를 저장합니다.  
   * **색상:** 색상을 나타내는 HEX 코드를 저장합니다. 연결된 텍스트 요소, 버튼 및 섹션 배경에 해당 색상을 사용할 수 있습니다.
* **구성 및 참조:**  
   * **참조:** 다른 콘텐츠 아이템을 참조해 콘텐츠 아이템 간의 관계를 만듭니다.  
   * **다중 참조:** 여러 콘텐츠 아이템을 참조해 콘텐츠 아이템 간에 다수의 관계를 만듭니다. 참조한 아이템을 여러 소스에 연결할 수도 있습니다.  
   * **태그:** 키워드나 설명 라벨을 사용해 콘텐츠 아이템을 관리하고 분류합니다.  
   * **카테고리:** 콘텐츠를 구성하고 필터링할 수 있도록 아이템을 카테고리에 지정합니다. 카테고리는 카테고리 컬렉션에서 관리되며 자동으로 양방향 연결이 생성됩니다. '카테고리' 입력란을 추가하면 연결된 카테고리 컬렉션에 '지정된 아이템' 입력란이 자동으로 생성되고, 아이템 컬렉션에는 숨겨진 '기본 카테고리' 입력란이 생성됩니다. [카테고리 컬렉션 사용 방법](https://support.wix.com/ko/article/cms-using-category-collections-to-organize-your-content)에 대해 자세히 알아보세요.
* **미디어:**  
   * **이미지:** JPG, PNG, GIF 등의 이미지 파일을 저장합니다.  
   **도움말:** 이미지 URL을 입력란에 붙여넣어 이미지를 추가할 수 있습니다.  
   * **미디어 갤러리:** 각 입력란에 여러 이미지 또는 동영상을 저장합니다.  
   * **동영상:** AVI, MPEG, MOV 등의 파일 형식을 사용해 각 아이템에 동영상 파일 하나를 저장합니다.  
   * **오디오:** MP3, WAV, FLAC 등의 파일 형식을 사용해 각 아이템에 오디오 파일 하나를 저장합니다.  
   * **문서:** PDF, CSV 등의 문서 파일을 각 아이템에 하나씩 저장합니다. **도움말:** 문서 URL을 입력란에 붙여넣어 문서를 추가할 수 있습니다.  
   * **여러 문서:** 각 아이템에 여러 문서 파일을 저장합니다. 문서 URL을 입력란에 붙여넣어 여러 문서를 추가할 수도 있습니다.  
   * **디지털 에셋:** 구매 후 고객에게 제공할 보안 파일을 아이템별로 하나씩 저장합니다. [카탈로그 컬렉션](https://support.wix.com/ko/article/cms-selling-items-from-catalog-collections)에서만 사용할 수 있으며, 판매용 디지털 파일로 매핑할 수 있습니다. ['디지털 에셋' 입력란 유형](https://support.wix.com/ko/article/cms-adding-the-digital-asset-field-type)에 대해 자세히 알아보세요.
* **시간 및 위치:**  
   * **날짜:** 콘텐츠 아이템과 관련된 날짜 값을 저장합니다.  
   **참고: 시간 입력란 포함** 체크박스가 '날짜 및 시간' 입력란 유형으로 대체되었습니다. 이전에 '날짜' 입력란에서 **시간 입력란 포함**을 활성화한 경우 '날짜 및 시간' 입력란으로 자동 전환되었습니다. 별도의 작업은 필요하지 않으며 기존 데이터는 그대로 유지됩니다.  
   * **날짜 및 시간:** 콘텐츠 아이템과 관련된 날짜 및 정확한 시간 값을 모두 저장합니다.  
   * **시간:** 관련 아이템의 시간 정보를 날짜와 별도로 저장합니다.  
   * **주소:** 도로명, 시/군/구, 주/도, 우편번호, 국가 등 실제 주소의 구조화된 데이터를 저장합니다.
* **자바스크립트(Velo 코드):**  
   * **객체:** 사용자 지정 객체 또는 데이터 구조를 사용해 복잡한 구조화 데이터를 관리합니다. 객체 입력란 유형을 사용하면 서로 관련된 여러 데이터를 하나의 단위로 저장하고 구성할 수 있습니다.  
   * **배열:** 하나의 입력란에 여러 값을 입력하고 관리합니다. 배열 입력란 유형을 사용하면 옵션 목록, 태그 또는 기타 관련 값과 같은 데이터 모음을 관리할 수 있습니다.

**참고:** Wix 하모니 에디터로 제작한 사이트에서는 이러한 입력란 유형을 모두 추가할 수 있지만, 아직 일부 유형(예: '참조', '동영상')은 요소에 연결할 수 없습니다. Wix 하모니에서 [더 많은 입력란 유형 연결 기능에 투표](https://support.wix.com/ko/article/wix-harmony-editor-feature-request-using-additional-collection-field-types-2)할 수 있습니다.

[지원되는 입력란 유형 및 제한 사항](https://support.wix.com/ko/article/cms-formerly-content-manager-supported-content-in-collection-field-types)에 대해 자세히 알아보세요.

![컬렉션 입력란을 선택하는 화면의 스크린샷입니다.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/06/05/9b800837-97ac-4a61-a54d-012f42762c3e/95c63fbb-6be2-41b8-82e1-35259b7543fd.png)

### 입력란 이름

입력란 이름은 컬렉션의 테이블 레이아웃에서 각 칼럼 상단에 표시됩니다. 요소를 컬렉션 입력란에 연결할 때도 입력란 이름을 확인할 수 있습니다. 입력란 이름을 변경하면 CMS 전체와 에디터에도 변경사항이 적용되지만, 라이브 사이트에는 영향을 주지 않습니다.

![CMS 컬렉션 입력란을 편집하는 화면의 스크린샷입니다.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/11/d6ec78c4-a5f5-42f5-be13-3adf201d9b84/b3c48f44-e62c-4ccd-b149-95a76a2e08a7.png)

### 입력란 ID(Velo by Wix 전용)

입력란 ID는 코드에서 [데이터 API](https://support.wix.com/ko/article/velo-working-with-the-data-api) 또는 [데이터세트 API](http://wix.to/94BuAAs/wix-dataset.html)를 사용해 입력란을 참조할 때 사용합니다. 예를 들어 데이터 API를 사용해 아이템을 삽입하려면 입력란 ID를 사용합니다.

```javascript
wixData.insert("CollectionName", {"fieldKey": "value"});
```

새 입력란을 추가하면 입력란 이름을 기반으로 입력란 ID가 자동 생성됩니다. 새 입력란을 추가하는 동안에는 입력란 ID를 편집할 수 있지만, 입력란을 생성한 후에는 변경할 수 없습니다. 입력란 ID는 **$**로 시작하거나 마침표('**.**')를 포함할 수 없습니다.

![컬렉션 입력란에 연결된 입력란 ID의 스크린샷입니다.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2025/01/02/c6834caf-0646-4524-9a54-faa390080dcd/b8faed7c-324e-43b3-8853-335485351f94.png)

### 도움말 텍스트(선택사항)

컬렉션에서 입력란의 용도를 설명하는 툴팁을 표시하려면 도움말 텍스트를 추가합니다. 도움말 텍스트를 저장하면 컬렉션의 입력란 이름 옆에 아이콘이 표시됩니다. 아이콘에 마우스오버하면 도움말 텍스트 툴팁을 확인할 수 있습니다. 이 텍스트는 컬렉션을 조회할 수 있는 [CMS 역할](https://support.wix.com/ko/article/cms-formerly-content-manager-creating-custom-roles-and-permissions)이 있는 공동 작업자에게만 컬렉션 내에서 표시됩니다.

![CMS 컬렉션에 도움말 텍스트가 표시되는 화면의 스크린샷입니다.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/11/0af377a3-bd3c-436c-9cf8-90f5e8283298/b9b6cace-0827-4409-8874-74ee00bf3073.png)

### 개인 식별 정보(PII)로 암호화

사회 보장 번호나 여권 번호와 같은 민감한 데이터를 백엔드에서 추가로 암호화하려면 이 버튼을 활성화합니다. '텍스트', '주소', '이메일' 입력란을 암호화할 수 있습니다. 새 '이메일' 입력란은 기본적으로 암호화가 활성화됩니다.

누구나 컬렉션을 조회할 수 있는 경우 암호화를 활성화하면 경고가 표시됩니다. [PII 데이터 저장](https://support.wix.com/ko/article/cms-storing-personally-identifiable-information-pii-data)에 대해 자세히 알아보세요.

![입력란 콘텐츠를 개인 식별 정보로 암호화하는 버튼을 활성화하는 화면의 스크린샷입니다.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/10/22/c8ae4fa0-99b6-49c7-b979-8500771f319f/Savesjsj.png)

---

## 시스템 필드

CMS는 백엔드 코드에서 사용하는 시스템 필드를 각 컬렉션에 자동으로 생성합니다. 컬렉션에 동적 페이지를 추가하면 동적 목록 페이지와 동적 아이템 페이지의 페이지 링크 입력란도 시스템 필드로 자동 생성됩니다. 기본 시스템 필드는 컬렉션에서 숨겨져 있지만, 컬렉션에서 **입력란 관리**를 클릭하면 확인할 수 있습니다. 

  
 아래 테이블에서 기본 시스템 필드를 확인하세요.

| 입력란 이름 | 입력란 ID | 입력란 유형 | 설명 |
| --- | --- | --- | --- |
| ID | \_id | 텍스트 | 아이템의 고유 식별자입니다. CSV 파일에서 새 콘텐츠를 가져올 때 ID 값을 지정할 수 있습니다. 값을 지정하지 않으면 임의의 UUID가 ID로 사용됩니다.      Wix Velo를 사용하는 경우 Data API로 아이템을 추가할 때도 ID 값을 지정할 수 있습니다.      한 번 지정한 ID는 편집할 수 없습니다. |
| 생성 날짜 | \_createdDate | 날짜 및 시간 | 아이템이 컬렉션에 추가된 날짜와 시간입니다. |
| 업데이트 날짜 | \_updatedDate | 날짜 및 시간 | 컬렉션에서 아이템을 마지막으로 수정한 날짜와 시간입니다. |
| 소유자 | \_owner | 텍스트 | 아이템을 만든 사용자의 고유 식별자입니다. 각 아이템을 만든 사용자를 확인하기 위해 [컬렉션 권한](https://support.wix.com/ko/article/cms-collection-permissions-overview)에서 사용됩니다. |

> **참고:** [내보낸 CSV 파일](https://support.wix.com/ko/article/cms-formerly-content-manager-exporting-content-from-your-collection)의 시간 입력란은 현지 시간이 아닌 UTC+0을 기준으로 표시됩니다.

---

## 기본 카테고리 입력란

컬렉션에 '카테고리' 입력란을 추가하면 숨겨진 '기본 카테고리' 입력란이 자동으로 생성됩니다. 이 입력란에는 여러 카테고리가 지정된 아이템의 기본 카테고리가 저장됩니다. 

  
**기본 카테고리가 중요한 이유:** 기본 카테고리는 검색 엔진이 콘텐츠 구조를 이해하는 데 도움이 됩니다. 아이템이 여러 카테고리에 속한 경우, SEO 측면에서 해당 아이템을 가장 잘 나타내는 카테고리를 검색 엔진에 알려줍니다. 

  
**기본 카테고리 작동 방식:** 

* 아이템에 처음 지정한 카테고리가 자동으로 기본 카테고리가 됩니다.
* '카테고리' 입력란에서 다른 카테고리 옆의 **플래그**![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/04/28/0c8c278e-9c15-4ada-bb75-7ba10bda7813/e6de704f-6ed7-4a2f-a61c-2e10d3e459d9.png) 아이콘을 클릭해 기본 카테고리를 변경할 수 있습니다.
* 컬렉션 보기에서 '기본 카테고리' 입력란의 숨김을 해제하면 각 아이템의 기본 카테고리를 확인할 수 있습니다. '카테고리' 입력란에 여러 카테고리가 있어도 기본 카테고리는 하나만 표시됩니다.
* '기본 카테고리' 입력란만 별도로 삭제할 수는 없습니다. 연결된 '카테고리' 입력란을 삭제할 때 함께 삭제됩니다.

  
[기본 카테고리 관리](https://support.wix.com/ko/article/cms-using-category-collections-to-organize-your-content#step-4-managing-the-primary-category)에 대해 자세히 알아보세요.

![컬렉션에서 숨김 해제된 기본 카테고리 입력란을 보여주는 스크린샷입니다.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/05/14/ffa93cc8-2e20-41f1-9bbd-92051a4b2e88/d2969d08-bbd2-4c50-ae75-9826de3056cc.png)

---

## 페이지 링크 입력란

동적 페이지를 생성하면 페이지 링크 입력란이 컬렉션에 시스템 필드로 자동 생성됩니다. 이 입력란은 동적 목록 페이지로 연결되는 링크와 동적 아이템 페이지에서 각 아이템의 고유 URL을 생성합니다. 

  
 페이지 링크 입력란의 형식은 동적 페이지 유형에 따라 달라집니다. 

* **동적 목록 페이지:** 기본적으로 페이지 링크 URL은 동적 목록 페이지의 웹 주소 끝에 컬렉션 이름을 추가합니다.
* **동적 아이템 페이지:** 기본적으로 페이지 링크 URL은 각 아이템의 동적 아이템 페이지 웹 주소 끝에 기본 입력란 값을 추가합니다.

> **참고:** Wix 하모니 에디터로 제작한 사이트에서는 아이템 페이지 URL에 **아이템 슬러그** 입력란을 대신 사용합니다. Wix 하모니에서 아이템 페이지를 생성하면 이 입력란이 컬렉션에 추가됩니다. [Wix 하모니의 아이템 페이지 URL](https://support.wix.com/ko/article/wix-harmony-editor-whats-new-with-item-pages#item-page-urls)에 대해 자세히 알아보세요.

![동적 아이템 페이지 및 동적 목록 페이지의 페이지 링크 입력란을 보여주는 스크린샷입니다.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/11/cd98d531-9052-43d6-8064-0cfc6b633ce6/95a77bd3-2cfa-45be-a351-ddd00fc42bb7.png)

> **도움말:** 에디터의 페이지 설정으로 이동해 [동적 페이지에 사용되는 변수를 사용자 지정](https://support.wix.com/ko/article/cms-creating-unique-dynamic-page-urls)합니다. 에디터에서 URL 값을 편집하면 컬렉션의 페이지 링크 입력란이 자동으로 업데이트됩니다.
