Dynamic list pages allow you to showcase various items from your CMS collection in an organized index. Each item, displayed in a repeater, gallery, or table, links to the collections' dynamic item page where visitors read more about the specific item.

A dataset controls the connections between the page elements and your collection fields. In the dataset settings, you can control the number of items that appear at a time. You can add filters to only include certain items or add sort conditions that control the order in which they appear.

Add 'Load More' or navigational buttons to improve your page loading performance if you have a lot of items to show. You can also give visitors the ability to filter the items they see on the page by using input elements like dropdowns, radio buttons, or checkboxes.

Before you begin:

• Create a CMS collection that includes the items you want to display on your dynamic list page.

• Create a dynamic item page for your collection. You will link items on your dynamic list page to your collection's dynamic item page. Alternatively, you can add the dynamic item page at the same time as your dynamic list page. See step 1 below for directions.

Step 1 | Add a dynamic list page

From your editor's CMS panel, create a dynamic list page for your collection. This adds a new page that displays different items from your collection in a repeater that you will customize later.

Wix Editor

Studio Editor

1. Go to your editor.

2. Click CMS  on the left side of the editor.

3. Click Your Collections.

4. Click the collection that you want to create your dynamic list page from.

5. Click More Actions and select Add dynamic page.

6. Select List page and click Add to Site.
   Tip: Select Item page as well to add a dynamic item page for the collection at the same time.

Step 2 | (Optional) Modify the URL slug structure

You may want to edit the URL slug structure of your dynamic list page to keep the web addresses of your dynamic pages organized.

For example, you could create the following URL slug structures for your dynamic pages:

• Dynamic list page: https://www.{your-domain.com}/{collection-name}

• Dynamic category page: https://www.{your-domain.com}/{collection-name}/{category}

• Dynamic item page: https://www.{your-domain.com}/{collection-name}/{category}/{primary-field}

When editing the URL slug structure, the structure cannot already be used by other existing pages on your site. To be unique, the URL slug structure cannot have the same prefix (e.g. {Collection name}) and the same number of variables as another page on your site, even if the variables are different.

Show me an example of conflicting URL slug structures that cannot be used

• 
  

• 
  

Important:

If you want the old dynamic URLs to automatically redirect to the new URLs you create, make sure your site first has a connected domain. If your site does not have a domain connected, the old URLs will no longer work and instead, will load 404 error pages.

To edit the URL slug structure of your dynamic list page:

Wix Editor

Studio Editor

1. Go to your editor.

2. Click Pages & Menuon the left side of the editor.

3. Click Dynamic Pages.

4. Hover over the dynamic list page you just created and click the More Actions icon  on the right. 
   Tip: By default, the dynamic list page you created is titled: {Collection Name} (List)

5. Click SEO.

6. Edit the URL slug structure field:
   Click Edit next to the URL slug structure field and choose what you want to do:Add Variable: Click + Add Variable and choose a 'Text' or 'Number' field to use its values in the URL slug structure.
   Add static values: Click the field and enter the static values you want to use in the URL slug structure. Use only English letters, numbers or dashes.
   Click Save.
   

1. Click Replace URLs to confirm the changes. The dynamic page's previous URLs will be deleted and will no longer work. Instead, the new URLs will be generated for the dynamic page.

Step 3 | Connect the repeater to the CMS

You now have a dynamic list page with a repeater that includes 2 text elements, an image, and a button in each container. Each of your repeater's containers displays a different item from your collection.

Connect each part of the elements to the relevant collection fields to ensure they display the info you want them to. We recommend connecting the button to your collection's dynamic item page so visitors can click to go to the relevant item's dedicated page.

To provide more info about each item, you can attach more supported elements to the repeater. Then connect these elements to your collection fields in the dataset where you manage all the CMS connections.

Want to use a gallery or table instead of a repeater?

If you'd rather display your collection items in a gallery or table, you can. Delete the default repeater then add a pro gallery or table. Then connect each part of your gallery or table to the CMS collection through the dataset, in the same way you would connect the repeater.

Wix Editor

Studio Editor

1. (Optional) Add elements to your repeater (e.g. buttons, text, images) or remove elements you do not need. You can adjust the size of the repeater so it can contain all the elements.

2. Click the repeater element and select the Connect to CMS icon .

3. In the Connect Repeater panel on the right, click the element you want to connect.

4. Under Connections, click the relevant drop-downs to connect the element to the relevant collection field or dataset action. The options vary depending on the element type.

Tips:

• To link the button element to the dynamic item page, click the Click action connects to field and select the collection's dynamic item page that ends with (Item).

• To link an image element to the dynamic item page, click the Link connects to drop-down and select the collection's dynamic item page that ends with (Item).

1. Click Repeater connections at the top of the panel on the right.

2. Repeat steps 3-5 above to connect the elements to collection fields or dataset actions.

1. Click to adjust your repeater elements as needed.
   Tip: You can add or remove elements from your repeater at any time. Disconnect elements if you want to use static content that doesn't change.

2. Click Preview to test your dynamic list page.

3. Click Publish if you are ready to make the changes go live.

Step 4 | (Optional) Manage the dataset settings

By default, your dynamic page dataset allows up to 100 items to initially display in your repeater or gallery. You can adjust the items per load to allow up to 1000 items to load at a time. You can also add filters to include only certain items, or add sorts to control the order in which the items display.

Wix Editor

Studio Editor

1. 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.
   

2. (Optional) Click the permission type next to Permissions to determine who can view, add, update, or delete collection content on your live site.

3. (Optional) Click the Dataset name field if you need to edit the name of the dataset.

4. (Velo only) Click the Dataset ID field to edit the ID used to identify the dataset in your page's code.

5. Click the Dataset mode drop-down and select the relevant option:Read: Connected elements can read and display content from your collection. The elements cannot modify the collection content.
   Read & Write: Connected elements can display content from your collection. Input elements can add or edit content in your collection.
   

6. Edit the Items per load field to set the maximum number of items that can load at a time. This is also the maximum number of items that can load when visitors click 'Load More' buttons, 'Next/Previous page' buttons, or pagination bars. See the next section for steps. 
   Note: This field does not apply to tables. If using a table to display your items, limit the number of items displayed by clicking the table's Layout icon , then setting a custom table height and enabling pagination.

1. (Optional) Click + Add Filter to only show specific items in the repeater.

2. (Optional) Click + Add new sort to choose the order in which the items appear in the repeater.

3. Click Preview to test your dynamic list page.

4. Click Publish if you are ready to make the changes go live.

Step 5 | (Optional) Create 'Load More' or navigational buttons

If you plan on displaying many items on this page, consider adding a 'Load More' button to improve the page's loading performance. The dataset's Items per load field determines how many items can initially load on the page and how many additional items can load when visitors click your 'Load More' button.

You can also add 'Next/Previous Page' buttons or a pagination bar (Wix Editor only) that cause the page's connected repeater or gallery to display the next or previous 'page' of items. The Items per load field determines the maximum items that appear in each 'page' of items.

Wix Editor

Studio Editor

Choose what you want to do:

Create a 'Load More' button

1. 

2. 
   

3. 

4. 
   

5. 

6. 

7. 
   

8. 
   

Create 'Next Page' and 'Previous Page' buttons

1. 

2. 
   

3. 

4. 
   

5. 

6. 

7. 
   

8. 
   

9. 
   

10. 

11. 

12. 
    

13. 
    

Tip:

In the Wix Editor, you can also connect a pagination bar that allows visitors to cycle through 'pages' of items. The Items per load field determines how many items can appear in each 'page' of the pagination bar. If you would like to see pagination bars in the Studio Editor, vote for this feature here.

Step 6 | (Optional) Let visitors filter items

Give visitors ways to filter the items that appear on your dynamic list page with input elements. Choose from any of the following input elements that allow filtering: Radio Buttons, Checkboxes, Dropdown, Selection Tags, or Slider (Range Sliders only).

Learn how to set up input elements that allow visitors to filter collection content.

FAQs

Click the questions below for answers to common questions about setting up dynamic list pages.

How do visitors get to my dynamic list page?

To ensure visitors can access your dynamic list page, we recommend adding a link to it in your site's menu. You could also link other elements such as text, buttons, or images to your dynamic list page.

Learn how to add a link to your dynamic list page that appears in your site's menu.

Can I create dynamic pages that list items by category?

Yes. You can create a dynamic 'category' page with a different version for each category. In each version, visitors view a list of the items within the category and can click to view the specific items.

For example, let's say you're a book blogger with reviews for many different genres like mystery, romance, and fantasy. By setting up dynamic pages for each genre, your book-loving visitors can easily navigate to the reviews they are interested in, improving their experience.

This allows you to establish dynamic pages for each category, adjust URL structures, personalize your pages, and, if desired, create an overarching dynamic page that displays all your categories.

Learn how to create dynamic pages that list items by category.

Why doesn't my page show the items I connected?

There are several setup factors that can cause your repeater, gallery or table to not load the connected items. The most common reasons involve the dataset settings, collection permissions, and sandbox syncing.

Check the following to troubleshoot your connections:

• Make sure all the elements in your repeater are properly connected to the same dynamic page dataset.

• Check in the dataset settings that your Items per load field and your filters and sort conditions are set correctly.

• Check that you're using the correct collection permissions.

• If sandbox is enabled, ensure the sandbox and live collections are synced.

• If the URL slug was recently updated, we recommend setting up a 301 redirect.

Learn more ways to troubleshoot CMS collection issues.

How do I link the items to their 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 (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.