CMS: Displaying Collection Content in a Repeater
Connect repeaters to the CMS (Content Management System) to display dynamic content from your collections. After connecting a repeater to a dataset that binds to your collection, choose which fields connect to each repeater element. Once connected, each item in your repeater displays content from a different collection item. This allows you to use a consistent layout that automatically populates content for all the items you want to show on your page.Before you begin:Make sure to add the CMS to your site if you haven't already. Step 1 | Create a CMS collectionCreate a multiple item collection for storing the content you want to use in your repeater. Add collection fields that will connect to the elements in your repeater. Then add the items that will appear in your repeater and fill in the fields for each item. Set your collection permissions to determine the type of content you want to store and who has access to manage it. Wix EditorStudio EditorDashboard
Go to your editor. Click CMS  on the left side of the editor. Click Create Collection. Enter a name for your collection.  Leave Multiple items (Default) selected and click Create.  Add fields to your collection manually or by importing a CSV file:
    
Add fields manually: Click + Add Field to begin adding fields to your collection manually. Import a CSV file: Click Import CSV file to upload a CSV file to your collection.    Add items to your collection:
    
Click + Add Item. Add content about the item to each relevant field.  Repeat this step to create as many items as you need.   
Set permissions for the collection: 
    
Click More Actions and select Permissions & privacy.  Choose which permissions to use for the collection:
Note: Site owners and collaborators are always treated as admins when logged in to the live site. This means they can always view, add, update, and delete collection content from the live site. This rule applies no matter which collection permission you select.   Show contentAllow the collection content to be viewable on the live site by site visitors. 
Click Show content. Click the Who can view this content? drop-down and choose an option: 
    
Everyone: Any site visitor can view the collection content on the live site.  Members only: Only site members can view the collection content on the live site.    Click Save. Collect contentAllow visitors to add content to the collection with input elements or API.  Note: This permission does not allow visitors to update existing content in the collection. Use the Custom permissions if you want to allow visitors to update existing content. See this FAQ section for more information. 
Click Collect content.  Click the Who can add content to this collection? drop-down and choose an option: 
    
Everyone: Any site visitor can add content to the collection from the live site.  Members only: Only site members can add content to the collection from the live site.    Click the Who can view this content? drop-down and choose an option: 
    
Admin: Site owners and collaborators can view the collection content from the live site.  Members only: Only site members can view the collection content from the live site.  Everyone: Any site visitor can view the collection content from the live site.    Click Save.CustomSet custom permissions to control who can view, add, update, and delete content. You can choose different permissions for item creators, site members, and everyone else. 
Click Custom. Click the relevant checkboxes next to each role to choose whether visitors with the role can view, add, update, or delete collection content from the live site:
    
Admin: Site owners and collaborators always have view, add, update, and delete permissions from the live site. You cannot change the permissions associated with this admin role.  Item's creator: This role's permissions only apply to the specific items that a member creates themselves. For example, the item's creator can only view, add, update, or delete collection items they created. Members only: This role applies to members of your site only. Selecting a permission for this role also selects the permission for the "Item's creator" role.  Everyone: This role applies to everyone who can access your live site. Selecting a permission for this role also selects the permission for the "Members only" and "Item's creator" role.    Click Save. 
Go to your editor. Click CMS  on the left side of the editor.  Click Create Collection. Enter a name for your collection.  Leave Multiple items (Default) selected and click Create.  Add fields to your collection manually or by importing a CSV file:
    
Add fields manually: Click + Add Field to begin adding fields to your collection manually. Import a CSV file: Click Import CSV file to upload a CSV file to your collection.    Add items to your collection:
    
Click + Add Item. Add content about the item to each relevant field.  Repeat this step to create as many items as you need.   
Set permissions for the collection: 
    
Click More Actions and select Permissions & privacy.  Choose which permissions to use for the collection:
Note: Site owners and collaborators are always treated as admins when logged in to the live site. This means they can always view, add, update, and delete collection content from the live site. This rule applies no matter which collection permission you select.   Show contentAllow the collection content to be viewable on the live site by site visitors. 
Click Show content. Click the Who can view this content? drop-down and choose an option: 
    
Everyone: Any site visitor can view the collection content on the live site.  Members only: Only site members can view the collection content on the live site.    Click Save. Collect contentAllow visitors to add content to the collection with input elements or API.  Note: This permission does not allow visitors to update existing content in the collection. Use the Custom permissions if you want to allow visitors to update existing content. See this FAQ section for more information. 
Click Collect content.  Click the Who can add content to this collection? drop-down and choose an option: 
    
Everyone: Any site visitor can add content to the collection from the live site.  Members only: Only site members can add content to the collection from the live site.    Click the Who can view this content? drop-down and choose an option: 
    
Admin: Site owners and collaborators can view the collection content from the live site.  Members only: Only site members can view the collection content from the live site.  Everyone: Any site visitor can view the collection content from the live site.    Click Save.CustomSet custom permissions to control who can view, add, update, and delete content. You can choose different permissions for item creators, site members, and everyone else. 
Click Custom. Click the relevant checkboxes next to each role to choose whether visitors with the role can view, add, update, or delete collection content from the live site:
    
Admin: Site owners and collaborators always have view, add, update, and delete permissions from the live site. You cannot change the permissions associated with this admin role.  Item's creator: This role's permissions only apply to the specific items that a member creates themselves. For example, the item's creator can only view, add, update, or delete collection items they created. Members only: This role applies to members of your site only. Selecting a permission for this role also selects the permission for the "Item's creator" role.  Everyone: This role applies to everyone who can access your live site. Selecting a permission for this role also selects the permission for the "Members only" and "Item's creator" role.    Click Save. 
Go to CMS in your site's dashboard.  Click Create Collection. Enter a name for your collection.  Leave Multiple items (Default) selected and click Create.  Add fields to your collection manually or by importing a CSV file:
    
Add fields manually: Click + Add Field to begin adding fields to your collection manually. Import a CSV file: Click Import CSV file to upload a CSV file to your collection.    Add items to your collection:
    
Click + Add Item. Add content about the item to each relevant field.  Repeat this step to create as many items as you need.   
Set permissions for the collection: 
    
Click More Actions and select Permissions & privacy.  Choose which permissions to use for the collection:
Note: Site owners and collaborators are always treated as admins when logged in to the live site. This means they can always view, add, update, and delete collection content from the live site. This rule applies no matter which collection permission you select.   Show contentAllow the collection content to be viewable on the live site by site visitors. 
Click Show content. Click the Who can view this content? drop-down and choose an option: 
    
Everyone: Any site visitor can view the collection content on the live site.  Members only: Only site members can view the collection content on the live site.    Click Save. Collect contentAllow visitors to add content to the collection with input elements or API.  Note: This permission does not allow visitors to update existing content in the collection. Use the Custom permissions if you want to allow visitors to update existing content. See this FAQ section for more information. 
Click Collect content.  Click the Who can add content to this collection? drop-down and choose an option: 
    
Everyone: Any site visitor can add content to the collection from the live site.  Members only: Only site members can add content to the collection from the live site.    Click the Who can view this content? drop-down and choose an option: 
    
Admin: Site owners and collaborators can view the collection content from the live site.  Members only: Only site members can view the collection content from the live site.  Everyone: Any site visitor can view the collection content from the live site.    Click Save.CustomSet custom permissions to control who can view, add, update, and delete content. You can choose different permissions for item creators, site members, and everyone else. 
Click Custom. Click the relevant checkboxes next to each role to choose whether visitors with the role can view, add, update, or delete collection content from the live site:
    
Admin: Site owners and collaborators always have view, add, update, and delete permissions from the live site. You cannot change the permissions associated with this admin role.  Item's creator: This role's permissions only apply to the specific items that a member creates themselves. For example, the item's creator can only view, add, update, or delete collection items they created. Members only: This role applies to members of your site only. Selecting a permission for this role also selects the permission for the "Item's creator" role.  Everyone: This role applies to everyone who can access your live site. Selecting a permission for this role also selects the permission for the "Members only" and "Item's creator" role.    Click Save. Step 2 | Add and customize your repeaterAdd a repeater then drag elements such as text, images, or buttons onto its items/containers. You can adjust the size of the repeater or remove elements to make sure everything you need in the repeater can fit. When you add an element to a repeater, the element is automatically added to each repeater item. Later, you will connect the elements to collection fields to replace the content. Each repeater item will show a different item from your collection.Wix EditorStudio Editor
Go to your editor. Go to the page or section where you want to add your repeater. Click Add Elements  on the left side of the editor. Click List. Click and drag the repeater you want to use onto the page. 
Add or remove elements from your repeater. You can resize the repeater so it can fit all the necessary elements inside it. Later, you will connect the elements to collection fields to replace the content. Each repeater item will show a different item from your collection.
Go to your editor. Go to the page or section where you want to add your repeater. Click Add Elements  on the left side of the editor. Click Layout Tools Click Repeaters.  Click and drag the repeater you want to use onto the page. 
Add elements to your repeater such as text, images and buttons. You can also delete elements from the repeater if you don't need them. Later, you will connect the elements to the relevant collection fields. Each repeater item will show a different item from your collection. Tip: Select a repeater item and click Add Media to add an image as the background. In the next step, you can select the image and click the Connect to CMS icon  to connect it to images in your collection.Important: Make sure your repeater contains a button or image element, so you can link to the dynamic item page. This lets visitors click the image or button to navigate to the relevant item in the dynamic item page. Step 3 | Connect the repeater items to your collectionDatasets are the tool you use to connect your repeater elements to your collection fields. Once you connect an element to a dataset, you can choose which collection fields to use with each part of the element. Connect each element that you want to display collection content in. Then resize, move, or adjust the elements to your liking. Wix EditorStudio Editor
In your editor, click the repeater you added. Click the Connect to CMS icon  . Click the Choose a dataset drop-down and select an existing dataset that connects to your collection. Alternatively, click Add a Dataset, then choose the collection you want to connect, give it a name and click Create.
Under Connections, click the element you want to connect first.  (Optional) If you want to connect the element to a different dataset, click the Choose a dataset drop-down and select another dataset. Otherwise, leave it connected to the same dataset.  Under Connections, click the relevant drop-downs to connect each part of the element to the relevant collection field. The options vary depending on the element type.Tips:
To link the button element to the collection's dynamic item page, click the Click action connects to field and select the dynamic item page that ends with (Item). To link an image element to the collection's dynamic item page, click the Link connects to drop-down and select the dynamic item page that ends with (Item).
Click Repeater connections at the top of the panel on the right.  Repeat steps 4-7 above to connect each element you want to display collection content in.  
(Optional) Click to resize, move, or adjust any of the elements in your repeater. You can add, remove, connect or disconnect elements at any time. 
In your editor, click the repeater you added. Click the Connect to CMS icon  . Connect a dataset by clicking an option from the Inspector panel on the right:
Note: The options vary, based on your total collections and datasets on the page. 
    
Add a Dataset: Choose the collection you want to connect, give the dataset a name and click Create.  Choose a dataset: Select the dataset you want to connect.  
Under Connections, click the element you want to connect first.  (Optional) If you want to connect the element to a different dataset, click the Choose a dataset drop-down and select another dataset. Otherwise, leave it connected to the same dataset.  Under Connections, click the relevant drop-downs to connect each part of the element to the relevant collection field. The options vary depending on the element type.Tips:
To link the button element to the collection's dynamic item page, click the Click action connects to field and select the dynamic item page that ends with (Item). To link an image element to the collection's dynamic item page, click the Link connects to drop-down and select the dynamic item page that ends with (Item).
Click Repeater Connections at the top of the panel. 
Repeat steps 4-7 above to connect each element you want to display collection content in.  
(Optional) Click to resize, move, or adjust any of the elements in your repeater. You can add, remove, connect or disconnect elements at any time. Step 4 | Manage the dataset settingsAdjust the dataset settings to control the dataset mode, the total items that can load at a time, the items that display, and the order in which they appear.  Wix EditorStudio Editor
Go to the repeater's connected dataset settings:
    
Click the repeater.  Click the Connect to CMS icon  . Click Dataset Settings in the Connect Repeater panel on the right.   Click the Dataset mode drop-down and select and option: 
    
Read: Allow the dataset to display your collection content in the repeater. Read & Write: Allow the dataset to display your collection content in the repeater and allow visitors to add or edit collection content with input elements.    Edit the Maximum items displayed field to adjust the maximum items that can initially load in the repeater. This is also the maximum items that can load when visitors click 'Load More' buttons, 'Next/Previous page' buttons, or pagination bars.  See the next section for steps. 
(Optional) Click + Add Filter to only show specific items in the repeater.  (Optional) Click + Add new sort to choose the order in which collection items appear in the repeater.
Go to the repeater's connected dataset settings:
    
Click the repeater.  Click the Connect to CMS icon  . Click Dataset Settings in the Inspector panel.  
Click the Dataset mode drop-down and select and option: 
    
Read: Allow the dataset to display your collection content in the repeater. Read & Write: Allow the dataset to display your collection content in the repeater and allow visitors to add or edit collection content with input elements.    Edit the Maximum items displayed field to adjust the maximum items that can initially load in the repeater. This is also the maximum items that can load when visitors click 'Load More' or 'Next/Previous page' buttons. See the next section for steps. (Optional) Click + Add Filter to only show specific items in the repeater.  (Optional) Click + Add Sort to choose the order in which collection items appear in the repeater.Step 5 | (Optional) Create 'Load More' or navigational buttonsYou can display up to 1000 items at a time in your repeater. However, if you want to display a lot of items, consider adding a 'Load More' button to improve loading performance. Adjust the 'Maximum items displayed' field to control the number of items that can load at a time in the dataset's connected repeater. The 'Maximum items displayed' field also determines the number of items displayed per 'page' in your repeater if you connect 'Next/Previous page' buttons or a pagination bar (Wix Editor only). Wix EditorStudio EditorChoose what you want to do: Create a 'Load More' button
Add a button to your page:
    
Click Add Elements  on the left side of the editor. Click Button, then drag the button onto your page where you want it to appear (e.g. below the repeater). Do not attach the button to your repeater.  
Tip: Alternatively, you can add an image and use it as your 'Load More' button.    Click Change Text and enter the text you want to display on the button (e.g. "Load More").  Click the Connect to CMS icon  . Click the Choose a dataset drop-down and select the same dataset that connects to your repeater.  Click the Click action connects to drop-down and select Load more. 
 Click the button and select the Design icon  to customize the appearance of your 'Load More' button. Click Preview to test your 'Load More' button. Click Publish if you are ready to make the changes go live.  Create 'Next Page' and 'Previous Page' buttons
Add a 'Next Page' button to your page:
    
Click Add Elements  on the left side of the editor. Click Button, then drag the button onto your page where you want it to appear (e.g. below the repeater). Do not attach the button to your repeater.  
Tip: Alternatively, you can add an image and use it as your 'Next Page' button.    Click Change Text and enter the text you want to display on the button (e.g. "Next Page").  Click the Connect to CMS icon  . Click the Choose a dataset drop-down and select the same dataset that connects to your repeater.  Click the Click action connects to drop-down and select Next page. 
 Click the button and select the Design icon  to customize the appearance of your 'Next Page' button. Duplicate your 'Next Page' button: 
    
Right-click the button (control + click on Mac).  Select Duplicate (or press Ctrl + D or ⌘ + D on Mac).    Click and drag the button where you want it to appear. Do not attach it to your repeater.  Click Change Text and enter the text you want to display on the button (e.g. "Previous Page").  Click the Connect to CMS icon  . Click the Click action connects to drop-down and select Previous page. 
 Click Preview to test your 'Next Page' and 'Previous Page' buttons. Click Publish if you are ready to make the changes go live. Connect a pagination barNote: Pagination bars are not relevant for static pages or dynamic item pages that can only display 1 item at a time. 
Add a pagination bar: 
    
Click Add Elements  on the left side of the editor. Click Interactive. Click Pagination Bar.  Click and drag the pagination bar you want to use onto the page.    Click Change Layout to adjust the layout.  Click the Design icon  on the pagination bar to edit the design.  Click the Connect to CMS icon . Click the Choose a dataset drop-down and select the same dataset that connects to your repeater. 
 Click and drag the edges of your pagination bar to resize it.  Click Preview to test your pagination bar.  Click Publish if you are ready to make the changes go live. View a full tutorial on adding and setting up a pagination bar. Choose what you want to do: Create a 'Load More' button
Add a button to your page:
    
Click Add Elements  on the left side of the editor. Click Button, then drag the button onto your page where you want it to appear (e.g. below the repeater). Do not attach the button to your repeater.   
Tip: Alternatively, you can add an image and use it as your 'Load More' button.    Click Change Text and enter the text you want to display on the button (e.g. "Load More").  Click the Connect to CMS icon  . Click the Choose a dataset drop-down and select the same dataset that connects to your repeater.  Click the Click action connects to drop-down and select Load more. 
 Click the button and select the Design tab  from the Inspector panel to customize the appearance of your 'Load More' button. Click the Preview icon  at the top right to test your 'Load More' button. Click Publish if you are ready to make the changes go live. Create 'Next Page' and 'Previous Page' buttons
Add a 'Next Page' button to your page:
    
Click Add Elements  on the left side of the editor. Click Button, then drag the button onto your page where you want it to appear (e.g. below the repeater). Do not attach the button to your repeater.  
Tip: Alternatively, you can add an image and use it as your 'Next Page' button.    Click Change Text and enter the text you want to display on the button (e.g. "Next Page").  Click the Connect to CMS icon  . Click the Choose a dataset drop-down and select the same dataset that connects to your repeater.  Click the Click action connects to drop-down and select Next page. 
 Click the button and select the Design tab  from the Inspector panel to customize the appearance of your 'Load More' button. Duplicate your 'Next Page' button: 
    
Select the button. Press Ctrl + D on your keyboard (or ⌘ + D on Mac).   Click and drag the button where you want it to appear. Do not attach it to your repeater.  Click Change Text and enter the text you want to display on the button (e.g. "Previous Page").  Click the Connect to CMS icon  . Click the Click action connects to drop-down and select Previous page. 
 Click the Preview icon  at the top right to test your 'Next Page' and 'Previous Page' buttons. Click Publish if you are ready to make the changes go live. Note: Pagination bars are not yet available in the Studio Editor. Vote for this feature if you would like to see it in the future. FAQsClick below for answers to the most frequently asked questions about connecting repeaters to the CMS. How can site visitors filter the content that appears in the repeater?To let site visitors filter the repeater content, connect input elements to the same dataset that connects to your repeater. View a step-by-step tutorial for allowing visitors to filter content with input elements.Why doesn't my repeater show the items I connected?There are several setup factors that can cause your repeater to not load the connected items. The most common reasons involve the dataset settings, collection permissions, and sandbox syncing. Learn how to troubleshoot CMS collection issues. How do I link a repeater item to a dynamic item page?You can set up your repeater so that clicking an image or button takes you to the item's dynamic item page. Make sure your repeater already has an image or button attached to it. When connecting the button or image (see step 3 above), click the Click action connects to drop-down and select the relevant dynamic item page.  Learn more about:
Displaying collection content on your page. Dataset actions for images and buttons.Why can't I attach some elements to the repeater?Currently, there are limitations to the types of elements you can add to repeaters. Learn more about which elements cannot be attached to repeaters. Can I see how a pre-connected repeater works before setting up my own?Yes. You can add a preset collection, built with sample items and fields, that adds dynamic pages to your site. Most presets add a dynamic list page with a repeater already connected to the collection so you can see how it works. The Portfolio preset adds a connected gallery instead of a repeater so choose a different preset to test a connected repeater.