# Wix Harmony Editor: Adding and Setting Up Repeaters

Source: https://support.wix.com/en/article/wix-harmony-adding-and-setting-up-repeaters (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

Repeaters turn your CMS (Content Management System) collections into designed lists on any page — portfolios, menus, property listings, and more. Add a repeater, connect it to a collection, and manage your content right where you design.

![Screenshot showing an example of a repeater with the Manage Items panel open. ](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/07/31/801fbc92-9bb5-4122-8ea8-028b0f0b972e/RepeaterExHarm.png)

---

## Adding a repeater and connecting your collection

Add a repeater from the Add panel, then connect it to a new or existing collection. Wix Harmony automatically matches the elements in your repeater — text, images, and buttons — to your collection's fields.

Elements that show collection content appear pink. Static elements appear blue.

### To add and connect a repeater:

1. [Go to your editor](https://manage.wix.com/account/site-selector/?actionUrl=https%3A%2F%2Fwww.wix.com%2Feditor%2F%7BmetaSiteId%7D%3FeditorSessionId%3D%7Besi%7D%26).
2. Click **+ Add** at the top left of the editor.
3. Select **Elements**.
4. Click **List** on the left side of the editor.
5. Click the **Repeaters** tab.
6. Drag a repeater you like onto your page.

![Screenshot of adding a repeater in the Wix Harmony editor. ](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. Click **Connect Collection** on your repeater.
2. Choose your content source:  
   * **New collection:** Create a collection to fill with your own content.  
   * **Existing collection:** Select a collection you've already created.

---

## Managing the items in your list

The **Items** tab of the **Manage Items** panel shows every item your repeater displays and where the content comes from. Add, edit, filter, and sort your items without leaving the editor.

### To manage your items:

1. Click your repeater, then click **Manage Items**.

![Screenshot of the manage items panel of a repeater. ](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/07/30/c6250793-fdbf-418b-bb51-a662fa50143c/ManageItemsHarm.png)

> **Tip:** **Where your content lives:** The top of the panel shows which collection your list comes from. Click the collection name to open it.

1. From the **Items** tab, choose what you want to do:  
   * **Add an item:** Click **+ Add item** at the bottom of the panel to create a new collection item.  
   * **Edit an item:** Click the **Edit** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/07/30/6e6fa990-6af7-4ada-9ef7-c5a484379f8a/EditIconHarmony.png) next to an item to update its content.  
   * **Filter your items:** Click **Filter** to show only items that match conditions you set. Learn more about [filtering the items that appear in your repeater](https://support.wix.com/en/article/wix-harmony-filtering-and-sorting-items-in-repeaters#filtering-the-items-in-your-repeater).  
   * **Sort your items:** Click **Sort** to choose the order your items appear in. Learn more about [sorting the items in your repeater](https://support.wix.com/en/article/wix-harmony-filtering-and-sorting-items-in-repeaters#sorting-the-items-in-your-repeater).  
   * **Replace the collection:** Click the **More Actions** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/07/30/05d7995e-6f4e-4ceb-8f4c-4a0ebc959fac/MoreActionsEdXIcon.png) in the panel and select **Replace collection** to connect a different collection. Wix Harmony automatically chooses which fields from the new collection replace the current ones in the elements. You can click **Check field matching** to make manual adjustments. Click **Replace Collection** when you're done.  
   ![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)  
   * **Create item pages:** Click the **More Actions** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/07/30/05d7995e-6f4e-4ceb-8f4c-4a0ebc959fac/MoreActionsEdXIcon.png) in the panel and select **Create a page for each item** to give every item its own page. Then choose a template and click **Add**.  
   * **Open your collection:** Click **Open collection** at the bottom of the panel to view and edit your full collection.

---

## Managing fields and connecting elements

The **Fields** tab lists every field in your collection, with a pink **Connected** label on fields that display on your page. Use it to put more of your content on the page or add new fields to your collection.

### To manage your fields:

1. Click your repeater, then click **Manage Items**.
2. Click the **Fields** tab.

![Screenshot of the Fields tab in the Manage Items panel.](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. Choose what you want to do:  
   * **Check a connection:** Hover over a field's **Connected** label to see which element uses it. Click the label to edit or remove the connection.  
   * **Show a field on your page:** Click **+ Add element** under a field to add a new element that displays its content. Then drag the element to the relevant location within your repeater.  
   * **Add a new field:** Click **+ Add Field**, then choose the field type (such as text, number, or image), name your field, and click **Add Field**.  
   * **Use system fields:** Click **System fields** to expand values Wix Harmony tracks for you — **ID**, **Created Date**, **Updated Date**, and **Owner**. Click **+ Add element** under any of them to display it.  
   * **Replace the collection:** Click the **More Actions** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/07/30/05d7995e-6f4e-4ceb-8f4c-4a0ebc959fac/MoreActionsEdXIcon.png) in the panel and select **Replace collection** to connect a different collection. Wix Harmony automatically chooses which fields from the new collection replace the current ones in the elements. You can click **Check field matching** to make manual adjustments. Click **Replace Collection** when you're done.  
   * **Create item pages:** Click the **More Actions** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/07/30/05d7995e-6f4e-4ceb-8f4c-4a0ebc959fac/MoreActionsEdXIcon.png) in the panel and select **Create a page for each item** to give every item its own page. Then choose a template and click **Add**.  
   * **Open your collection:** Click **Open Collection** at the bottom of the panel to view and edit your full collection.

---

## Connecting elements in your repeater

You can connect the text, image, button, and gallery elements inside your repeater to your collection directly on the page — without opening the **Manage Items** panel. On static pages, only elements inside a repeater can connect to your collection. Item pages display one item at a time, so [on those pages you can connect elements wherever you place them](https://support.wix.com/en/article/wix-harmony-editor-whats-new-with-item-pages#connecting-elements-on-your-item-page). Connect a gallery to a 'Media Gallery' field to show each item's images and videos. Learn more about [connecting the Wix Gallery to a Media Gallery field](https://support.wix.com/en/article/wix-harmony-editor-connecting-the-wix-gallery-to-a-media-gallery-field).

> **Note:** The label above an element shows whether it's connected to a collection. Blue means the element is static, pink means it's connected to your collection. Connected elements also show the name of the collection field they display, next to the **CMS** icon ![](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)

### To connect an element in your repeater:

1. Click the element in your repeater that you want to connect.
2. Connect the element to your CMS collection:  
   1. Click **Connect to {your collection}** or click the pink label with the connected field name.  
   2. Click the **Use content from a collection** icon ![](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. Click the **Choose field** dropdown and select the collection field you want the element to show.

![Screenshot of connecting a static element in a repeater to a collection field. ](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/08/18/4c3e1eaa-eb78-4e7a-9778-4a09db5c7926/kittenConnection.png)

---

## FAQs

Click a question below to learn more about repeaters.

**Can I change the layout of my repeater?**

Yes. You can display your repeater as cards, a list, a slider, or an advanced grid.

  
**To change the layout:**

1. Click your repeater in your editor.
2. Click **Layout**.
3. Click the **Change layout** dropdown and select the layout you want: **Cards**, **List**, **Slider**, **Advanced grid**
4. (Cards only) Enable the **Set items per row** toggle and edit the number to adjust the items per row.
5. (Slider only) Click the **Direction** dropdown and choose from **Left to Right** or **Top to Bottom**.

**Can I set how many items load in my repeater at a time?**

Yes. You can choose how many items your repeater loads at a time.

1. Click your repeater in your editor.
2. Click the **Settings** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/07/31/298bf9af-355b-450e-8475-3ab3852d1ddb/SettingsIcon.png) on the action bar.
3. Click the **Use content from a collection** icon ![](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. Drag the **Items per load** slider to set the number of items.

You can also [filter and sort the items your repeater displays](https://support.wix.com/en/article/wix-harmony-filtering-and-sorting-items-in-repeaters) from the Manage Items panel.

**Can I name my repeater for accessibility purposes?**

Yes. Add an accessible name to help visitors using assistive technology (e.g. screen readers) understand what your repeater shows. The name is not visible on your site.

1. Click your repeater in your editor.
2. Click the **Settings** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/07/31/298bf9af-355b-450e-8475-3ab3852d1ddb/SettingsIcon.png) on the action bar.
3. Click **Accessibility**.
4. Enter a short, unique description in the **Accessible name** field.

**Where can I adjust my repeater's design?**

You can customize your repeater’s design from the Design panel.

1. Click your repeater in your editor.
2. Click the **All design options** icon ![](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) on the action bar.
3. Choose what you want to customize: **Fill colors**, **Borders**, **Corners**, **Shadow**, **Spacing**, or **Layout**.
