Studio Two Editor: Adding and Setting Up Repeaters

Use filters to show only the items that match conditions you set. For example, show only properties with a garden, or only paintings that are for sale. When you add more than one filter, an item must match all of them to show.

1. Click Filter.

2. Click + New Filter.

3. Click Select field and select the field you want to filter by.

4. Select the condition items must match (e.g. is or starts with). The conditions depend on the field's type.

5. Enter the value items must match.

6. (Optional) Click + New Filter to add another filter.

7. Click Apply.

Use sorts to set the order your items appear in. You can add up to 3 sorts. Items follow your first sort, and items with the same value follow the next one. For example, sort by date, then by name for items with the same date.

1. Click Sort.

2. Click + New Sort.

3. Click Select field and select the field you want to sort by.

4. Select the order (e.g. A-Z or Z-A for text fields).

5. (Optional) Click + New Sort to add another sort for items that have the same value.

6. Click Apply.

Drag the Items per load slider or enter a number in the field to set how many items load at a time. On your live site, visitors see the next set of items as they scroll down. You can also click the Connect to data icon next to Items per load to use a number from a field in a data source.

To show more items only when visitors click, add a Load More button. Find the steps in the FAQs at the end of this article.

Click Set up with AI at the top of the panel. Then describe the list you want (e.g. "Show the 6 newest projects").

Click Manage Data at the bottom of the panel to open your collection in the CMS. Add, edit or delete items there, or add new fields.

Yes. Click the dropdown arrow next to Manage [source name] on the action bar and select Replace Connection. Select the new source, click Apply, then click Change.

You don't need to connect the elements in your repeater again. The editor connects them to fields in the new source for you. Check each element afterward. The editor might choose a different field than the one you want.

No. A repeater shows one source at a time. To show content from 2 sources, add a repeater for each one.

No. Your collection keeps all its items. Filters and sorts only change which items show on your site and in what order.

Yes. Add a repeater for each group and give each repeater its own filter. For example, add one repeater that shows "Featured" items and another that shows "Latest" items.

You can't drag items into a custom order. Instead, add a number field to your collection (e.g. "Display order"), give each item a number and sort by that field.

Yes. Add a button that shows the next set of items each time visitors click it. Each set has the number of items you choose under Items per load.

To do this, connect your section to a source first. Then connect your repeater and your button to the section's source. A source you connect to your repeater only works inside the repeater. A button outside the repeater can't use it.

Place the button outside your repeater (e.g. below it). A button inside your repeater shows up in every item.

To add a Load More button:

1. Go to your editor.
2. Make sure your repeater isn't connected to a source:
   • New repeater: Click Skip for now on the repeater's banner.
   • Connected repeater: Disconnect it, even if you want to use the same collection. Select your repeater and click the Open Inspector icon at the top right of the editor. In the Settings tab, click the More Actions icon next to the source under Connected sources and select Remove.
3. Connect your section to a collection:
   1. Select the section your repeater is in.
   2. (If not already open) Click the Open Inspector icon at the top right of the editor.
   3. (If not already open) Click the Settings tab.
   4. Click + Connect Source under Data sources.
   5. Select your collection under CMS collection.
4. Connect your repeater to the section's collection:
   1. Select your repeater.
   2. Click the Connect to data icon next to Display Items from under Properties.
   3. Click Select source and select the same collection. The field is selected for you.
   4. Click Apply.
5. Set how many items show with each click:
   1. Select your repeater and click the Data settings icon on the action bar.
   2. Drag the Items per load slider or enter a number in the field.
6. Add a button below your repeater and change its text (e.g. "Load More").
7. Stop your repeater from loading items as visitors scroll:
   1. Select your repeater.
   2. Scroll down to Event handlers under Advanced.
   3. Click the X next to Load More.
8. Connect your button to the collection:
   1. Select your button.
   2. Scroll down to Event handlers under Advanced.
   3. Click the Connect to data icon next to On Click.
   4. Click Select source and select the same collection.
   5. Click the Field dropdown and select Load More.
   6. Click Apply.

By default, they see nothing. When your repeater has no items to show, it doesn't appear on your live site. For example, this can happen when a filter doesn't match any items, or before you add items to your collection.

You can design what shows in your repeater's place instead. For example, add a message that says "No items found", or a button that links to another page.

To customize what shows when your repeater has no items:

1. Click your repeater.
2. Click the Regular mode dropdown on the repeater's label and select No Items.
3. Add and design the elements you want visitors to see inside the repeater.
4. Click the No Items dropdown and select Regular mode to go back to your items.

Yes. Click Change Layout on the action bar and select a layout: Cards, List, Slider or Advanced grid. With the Cards layout, you can also set how many items show in each row from the action bar.

Yes. Add a collection page and select Item page to show one item at a time with the same design. Learn more about adding and working with pages.

Yes. After you add some Wix apps to your site (e.g. Wix Bookings, Wix Stores or Wix Events), you can add elements for that app from the Add Elements panel. These elements are already connected to the app's data, so you don't need to connect them yourself.

For example, find Wix Bookings in the Add Elements panel and add a Service list to show your services in a repeater.

Yes, if each item in your source has its own list. For example, each service in Wix Bookings has its own list of staff members. To show that list, add a repeater inside an item of your main repeater. This works with lists from some Wix apps (e.g. Wix Bookings) and from custom code.