# Wix 하모니 에디터: 반복 레이아웃 추가 및 설정하기

Source: https://support.wix.com/ko/article/wix-harmony-editor-adding-and-setting-up-repeaters-ko (updated 2026-11-09)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

반복 레이아웃을 사용하면 CMS(콘텐츠 관리 시스템) 컬렉션을 포트폴리오, 메뉴, 숙소 목록 등 원하는 디자인의 목록으로 만들어 모든 페이지에 표시할 수 있습니다. 반복 레이아웃을 추가해 컬렉션에 연결하고, 디자인 작업 화면에서 바로 콘텐츠를 관리하세요.

![**아이템 관리** 패널이 열린 반복 레이아웃의 예시 스크린샷입니다.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/07/31/801fbc92-9bb5-4122-8ea8-028b0f0b972e/RepeaterExHarm.png)

---

## 반복 레이아웃 추가 및 컬렉션 연결하기

\*\*추가\*\* 패널에서 반복 레이아웃을 추가한 후 새 컬렉션이나 기존 컬렉션에 연결합니다. Wix 하모니가 반복 레이아웃의 텍스트, 이미지, 버튼 요소를 컬렉션 입력란에 자동으로 연결합니다.

컬렉션 콘텐츠를 표시하는 요소는 분홍색으로, 정적 요소는 파란색으로 표시됩니다.

### 반복 레이아웃을 추가하고 연결하려면 다음 단계를 따르세요.

1. [에디터로 이동합니다](https://manage.wix.com/account/site-selector/?actionUrl=https%3A%2F%2Fwww.wix.com%2Feditor%2F%7BmetaSiteId%7D%3FeditorSessionId%3D%7Besi%7D%26).
2. 에디터 왼쪽 상단에서 **+ 추가**를 클릭합니다.
3. **요소**를 선택합니다.
4. 에디터 왼쪽에서 **목록**을 클릭합니다.
5. **반복 레이아웃** 탭을 클릭합니다.
6. 원하는 반복 레이아웃을 페이지로 드래그합니다.

![Wix 하모니 에디터에서 반복 레이아웃을 추가하는 화면의 스크린샷입니다.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/07/30/4df37edd-62cc-4a5e-8da6-b82e8b2d4a60/HarmRepeater.png)

1. 반복 레이아웃에서 **컬렉션 연결**을 클릭합니다.
2. 콘텐츠 소스를 선택합니다.  
   * **새 컬렉션:** 직접 콘텐츠를 추가할 컬렉션을 생성합니다.  
   * **기존 컬렉션:** 이미 생성한 컬렉션을 선택합니다.

---

## 목록 아이템 관리하기

**아이템 관리** 패널의 **아이템** 탭에서 반복 레이아웃에 표시되는 모든 아이템과 콘텐츠의 출처를 확인할 수 있습니다. 에디터를 벗어나지 않고 아이템을 추가, 편집, 필터링 및 정렬할 수 있습니다.

### 아이템을 관리하려면 다음 단계를 따르세요.

1. 반복 레이아웃을 클릭한 후 **아이템 관리**를 클릭합니다.

![반복 레이아웃의 **아이템 관리** 패널을 보여 주는 스크린샷입니다.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/07/30/c6250793-fdbf-418b-bb51-a662fa50143c/ManageItemsHarm.png)

> **도움말:** **콘텐츠 저장 위치:** 패널 상단에서 목록에 연결된 컬렉션을 확인할 수 있습니다. 컬렉션을 열려면 컬렉션 이름을 클릭합니다.

1. **아이템** 탭에서 원하는 작업을 선택합니다.  
   * **아이템 추가:** 패널 하단에서 **+ 아이템 추가**를 클릭해 새 컬렉션 아이템을 추가합니다.  
   * **아이템 편집:** 콘텐츠를 업데이트하려면 아이템 옆의 **편집** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/07/30/6e6fa990-6af7-4ada-9ef7-c5a484379f8a/EditIconHarmony.png) 아이콘을 클릭합니다.  
   * **아이템 필터링: 필터**를 클릭해 설정한 조건과 일치하는 아이템만 표시합니다. [반복 레이아웃에 표시되는 아이템을 필터링하는 방법에 대해 자세히 알아보세요](https://support.wix.com/ko/article/wix-harmony-filtering-and-sorting-items-in-repeaters#filtering-the-items-in-your-repeater).  
   * **아이템 정렬: 정렬**을 클릭해 아이템의 표시 순서를 선택합니다. [반복 레이아웃의 아이템을 정렬하는 방법에 대해 자세히 알아보세요](https://support.wix.com/ko/article/wix-harmony-filtering-and-sorting-items-in-repeaters#sorting-the-items-in-your-repeater).  
   * **컬렉션 변경:** 패널에서 **추가 작업** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/07/30/05d7995e-6f4e-4ceb-8f4c-4a0ebc959fac/MoreActionsEdXIcon.png) 아이콘을 클릭한 후 **컬렉션 변경**을 선택해 다른 컬렉션을 연결합니다. Wix 하모니가 새 컬렉션에서 현재 입력란을 대체할 입력란을 자동으로 선택합니다. 직접 조정하려면 **입력란 연결 확인**을 클릭합니다. 완료되면 **컬렉션 변경**을 클릭합니다.  
   ![Screenshot of clicking check field matching to make adjustments.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/07/31/e7380c86-a243-44a8-8748-7ff5d2723aa1/CheckFieldMatch.png)  
   * **아이템 페이지 추가:** 패널에서 **추가 작업** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/07/30/05d7995e-6f4e-4ceb-8f4c-4a0ebc959fac/MoreActionsEdXIcon.png) 아이콘을 클릭한 후 **각 아이템용 페이지 추가**를 선택해 아이템마다 개별 페이지를 추가합니다. 템플릿을 선택한 후 **추가**를 클릭합니다.  
   * **컬렉션 열기:** 전체 컬렉션을 확인하고 편집하려면 패널 하단의 **컬렉션 열기**를 클릭합니다.

---

## 입력란 관리 및 요소 연결

**입력란** 탭에는 컬렉션의 모든 입력란이 표시되며, 페이지에 표시되는 입력란에는 분홍색 **연결됨** 라벨이 표시됩니다. 이 탭에서 더 많은 콘텐츠를 페이지에 표시하거나 컬렉션에 새 입력란을 추가할 수 있습니다.

### 입력란을 관리하려면 다음 단계를 따르세요.

1. 반복 레이아웃을 클릭한 후 **아이템 관리**를 클릭합니다.
2. **입력란** 탭을 클릭합니다.

![아이템 관리 패널의 입력란 탭을 보여주는 스크린샷입니다.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/07/31/9700d26e-34ce-4f4b-9574-1e76175d0226/Fieldddddds.png)

1. 원하는 작업을 선택합니다.  
   * **연결 확인:** 입력란의 **연결됨** 라벨에 마우스오버해 어떤 요소에서 해당 입력란을 사용하는지 확인합니다. 연결을 편집하거나 제거하려면 라벨을 클릭합니다.  
   * **페이지에 입력란 표시:** 입력란 아래에서 **+ 요소 추가**를 클릭해 해당 콘텐츠가 표시되는 새 요소를 추가합니다. 그다음 반복 레이아웃 내 원하는 위치로 요소를 드래그합니다.  
   * **새 입력란 추가: + 입력란 추가**를 클릭하고 텍스트, 숫자, 이미지 등의 입력란 유형을 선택한 후 입력란 이름을 입력하고 **입력란 추가**를 클릭합니다.  
   * **시스템 입력란 사용: 시스템 입력란**을 클릭해 Wix 하모니에서 자동으로 관리하는 값인 **ID**, **생성일**, **업데이트 날짜**, **소유자**를 펼칩니다. 표시하려는 시스템 입력란 아래에서 **+ 요소 추가**를 클릭합니다.  
   * **컬렉션 변경:** 패널에서 **추가 작업** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/07/30/05d7995e-6f4e-4ceb-8f4c-4a0ebc959fac/MoreActionsEdXIcon.png) 아이콘을 클릭한 후 **컬렉션 변경**을 선택해 다른 컬렉션을 연결합니다. Wix 하모니가 새 컬렉션에서 현재 입력란을 대체할 입력란을 자동으로 선택합니다. 직접 조정하려면 **입력란 연결 확인**을 클릭합니다. 완료되면 **컬렉션 변경**을 클릭합니다.  
   * **아이템 페이지 추가:** 패널에서 **추가 작업** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/07/30/05d7995e-6f4e-4ceb-8f4c-4a0ebc959fac/MoreActionsEdXIcon.png) 아이콘을 클릭한 후 **각 아이템용 페이지 추가**를 선택해 아이템마다 개별 페이지를 추가합니다. 템플릿을 선택한 후 **추가**를 클릭합니다.  
   * **컬렉션 열기:** 전체 컬렉션을 확인하고 편집하려면 패널 하단의 **컬렉션 열기**를 클릭합니다.

---

## 반복 레이아웃의 요소 연결

페이지에서 직접 반복 레이아웃 내 텍스트, 이미지, 버튼, 갤러리 요소를 컬렉션에 연결할 수 있어 **아이템 관리** 패널을 열 필요가 없습니다. 정적 페이지에서는 반복 레이아웃 내 요소만 컬렉션에 연결할 수 있습니다. 아이템 페이지에는 한 번에 아이템 하나만 표시되므로 [해당 페이지에서는 원하는 위치에 요소를 배치해 연결할 수 있습니다](https://support.wix.com/ko/article/wix-harmony-editor-whats-new-with-item-pages#connecting-elements-on-your-item-page). 각 아이템의 이미지와 동영상을 표시하려면 갤러리를 '미디어 갤러리' 입력란에 연결합니다. [Wix 갤러리를 미디어 갤러리 입력란에 연결하는 방법에 대해 자세히 알아보세요](https://support.wix.com/ko/article/wix-harmony-editor-connecting-the-wix-gallery-to-a-media-gallery-field).

> **참고:** 요소 위의 라벨에서 컬렉션 연결 여부를 확인할 수 있습니다. 파란색은 정적 요소, 분홍색은 컬렉션에 연결된 요소를 나타냅니다. 연결된 요소에는 표시 중인 컬렉션 입력란 이름도 **CMS** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/08/18/d2f24d6f-0c11-4968-9132-2275a4835b2b/PinkCMSIcon.png) 아이콘 옆에 표시됩니다.  
> ![Screen shot showing the pink label that shows the connected collection field name .](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/08/18/14807ce9-8c5c-4773-9e6f-076512b32378/PinkCOnnect.png)

### 반복 레이아웃의 요소를 연결하려면 다음 단계를 따르세요.

1. 연결하려는 반복 레이아웃 요소를 클릭합니다.
2. 요소를 CMS 컬렉션에 연결합니다.  
   1. **{your collection}에 연결**을 클릭하거나, 연결된 입력란 이름이 표시된 분홍색 라벨을 클릭합니다.  
   2. **컬렉션 콘텐츠 사용**![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/07/31/5b9616f3-b367-4151-9641-1aae4c08c996/ConnectCMSicon.png) 아이콘을 클릭합니다.  
   3. **입력란 선택** 드롭다운을 클릭한 후, 요소에 표시할 컬렉션 입력란을 선택합니다.

![반복 레이아웃의 정적 요소를 컬렉션 입력란에 연결하는 화면입니다.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/08/18/4c3e1eaa-eb78-4e7a-9778-4a09db5c7926/kittenConnection.png)

---

## 자주 묻는 질문

아래 질문을 클릭해 자세한 내용을 확인하세요.

**반복 레이아웃의 레이아웃을 변경할 수 있나요?**

네. 반복 레이아웃을 카드, 목록, 슬라이더 또는 고급 그리드로 표시할 수 있습니다.

  
**레이아웃을 변경하려면 다음 단계를 따르세요.**

1. 에디터에서 반복 레이아웃을 클릭합니다.
2. **레이아웃**을 클릭합니다.
3. **레이아웃 변경** 드롭다운을 클릭한 후 원하는 레이아웃을 선택합니다. **카드**, **목록**, **슬라이더**, **고급 그리드** 중에서 선택할 수 있습니다.
4. (카드만 해당) **행당 아이템 수 설정** 버튼을 활성화하고 숫자를 편집해 행당 아이템 수를 조정합니다.
5. (슬라이더만 해당) **방향** 드롭다운을 클릭한 후 **왼쪽에서 오른쪽** 또는 **위에서 아래**를 선택합니다.

**반복 레이아웃에서 한 번에 로드할 아이템 수를 설정할 수 있나요?**

네. 반복 레이아웃에서 한 번에 로드할 아이템 수를 선택할 수 있습니다.

1. 에디터에서 반복 레이아웃을 클릭합니다.
2. 액션바에서 **설정**![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/07/31/298bf9af-355b-450e-8475-3ab3852d1ddb/SettingsIcon.png) 아이콘을 클릭합니다.
3. **컬렉션 콘텐츠 사용**![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/07/31/5b9616f3-b367-4151-9641-1aae4c08c996/ConnectCMSicon.png) 아이콘을 클릭합니다.
4. **로딩당 아이템 수** 슬라이더를 드래그해 아이템 수를 설정합니다.

아이템 관리 패널에서 반복 레이아웃에 표시되는 아이템을 [필터링하고 정렬](https://support.wix.com/ko/article/wix-harmony-filtering-and-sorting-items-in-repeaters)할 수도 있습니다.

**접근성을 위해 반복 레이아웃에 이름을 지정할 수 있나요?**

네. 보조 기술(예: 스크린 리더)을 사용하는 방문자가 반복 레이아웃에 표시되는 내용을 이해할 수 있도록 접근성 이름을 추가합니다. 이 이름은 사이트에 표시되지 않습니다.

1. 에디터에서 반복 레이아웃을 클릭합니다.
2. 액션바에서 **설정**![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/07/31/298bf9af-355b-450e-8475-3ab3852d1ddb/SettingsIcon.png) 아이콘을 클릭합니다.
3. **접근성**을 클릭합니다.
4. **접근성 이름** 입력란에 짧고 고유한 설명을 입력합니다.

**반복 레이아웃의 디자인은 어디에서 조정할 수 있나요?**

디자인 패널에서 반복 레이아웃의 디자인을 사용자 지정할 수 있습니다.

1. 에디터에서 반복 레이아웃을 클릭합니다.
2. 액션바에서 **모든 디자인 옵션**![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/8696077d-830a-4b1e-bd86-9df98f89994a/2025/12/08/b9b20e55-7901-4ec5-b1ce-d7f4cbb45b2f/17a1f795-89f2-4caf-b3b3-b3ec22ab25b9.png) 아이콘을 클릭합니다.
3. 사용자 지정할 항목을 선택합니다. **채우기 색상**, **테두리**, **모서리**, **음영**, **간격** 또는 **레이아웃** 중에서 선택할 수 있습니다.
