CMS: About Dataset Click Actions for Buttons and Images

When connecting a button or image to a dataset, choose what action occurs when visitors click the element. The list of available actions varies depending on the dataset mode and whether you connect to a regular dataset or a dynamic page dataset. Learn more about all the available dataset click actions below. 

Use the dataset 'Editing Actions' to provide a way for visitors to add, edit, or delete content in your collection. To choose these actions, make sure to connect your button or image to a dataset that is in the Write or Read & Write mode. View the available dataset 'Editing Actions' below:

Use the 'Submit' click action to save information to your collection that visitors provide in input elements. 

Learn how to create a custom form using input elements that saves to your CMS collection.  

Use the 'New' click action to submit values from the dataset's connected input elements to your collection and then reset the inputs so they can accept new values. 

When the dataset mode is set to 'Write', the 'New' action can only add new items to your collection. 

In 'Read & Write' mode, the 'New' action can both add new items and update existing ones. In this mode, the inputs display the current values of an existing item. If you edit these values and click 'New', the updated values will replace the existing item's values. After this, the inputs reset. If you fill them out again and click 'New', the input values will create a new item in your collection.

Learn more about managing collection content from your live site.

Use the 'Revert' click action if you have input elements that can edit collection items and you want a way to cancel the last changes made to an item. The 'Revert' action restores the edited item to its previous version before the recent changes were made. It also clears the values of the connected input elements.  

Use the 'Delete' click action if you have input elements that can edit collection items and you want a way to delete an item. The 'Delete' action removes the currently displayed item from your collection. 

Use the dataset 'List Actions' when you need a button to interact with other elements that read content from your collection. Make sure to connect your button or image to a dataset that is set to the Read or Read & Write mode. View the available dataset 'List Actions' below:

Use the 'Load more' click action to load additional items in the dataset's connected repeater or gallery. The 'Items per load' field in the dataset settings determines both the number of items that initially load, and how many more items can load when visitors click the button. The dataset's filters and sort conditions also determine which items load and the order in which they appear.

Learn how to add a 'Load More' button to a repeater or gallery.

Use the 'Apply filters' action if you have input elements that filter content and you only want the filters to apply after clicking a separate button. When visitors click the 'Apply filters' button, any input element filters they selected get applied to the dataset's connected elements. 

Without an 'Apply filters' action, the filters apply as soon as the visitor selects them from the input elements. 

The 'Reset input values' action clears the values of all input elements set to filter content. This allows visitors to easily reset any selections they've made when using input elements to filter content. 

Use the 'Next/Previous item' actions to cause connected elements to display content from the next or previous item retrieved by the dataset. When visitors click the 'Next/Previous item' buttons, the dataset's filters and sort conditions determine which collection item loads. 

The 'Next/Previous item' actions can also be used by visitors to edit collection content. If you connected input elements to a Read & Write mode dataset, when visitors click the 'Next item' button, their inputs write to the current collection item before loading the next item. The same concept applies to the 'Previous item' click action, which writes to the collection before loading the previous item. Learn more about managing collection content from your live site. 

Use the 'Navigation Actions' to create buttons that take your visitor to the next or previous dynamic page retrieved by the dataset, or to specific dynamic pages. View the available dataset 'Navigation Actions' below:

Use the 'Next/Previous page' actions to cause connected repeaters and galleries to display the next or previous 'page' of items. The dataset's Items per load field determines how many items are on each 'page'. The dataset's filters and sort conditions determine which items load and the order in which they appear in each 'page'.

For example, if you click a 'Next page' button and the dataset's Items per load field is "10", the next 10 items retrieved by the dataset load in the repeater or gallery. 

These click actions are similar to the 'Load more' action. However, instead of loading additional items, the 'Next/Previous page' actions replace the existing items with a new 'page' of items in the repeater or gallery. 

On a dynamic item page, the 'Next/previous dynamic page' actions take visitors to the next or previous item's version (dynamic URL) of the dynamic page. In the dataset settings, the dataset's sort condition determines the order in which the next or previous dynamic page URLs load. You can add a filter to the dataset to include or exclude specific items' dynamic page URLs from loading. 

For example, with the 'Next dynamic page' action, if the dataset sorts a number field type from low to high, the item with the next highest number will load next. If the dataset has a filter that excludes certain items from loading, these excluded items will be skipped and the next available item page loads. 

When visitors are on the last item page returned by the dataset, the 'Next dynamic page' click action is disabled. This is because there are no more item pages remaining that can load from the dataset. The same concept applies to the 'Previous dynamic page' click action. If visitors are on the first item page returned by the dataset, the 'Previous dynamic page' click action is disabled since there are no previous item pages to load. 

The 'Next/Previous dynamic page' actions can also be used by visitors to edit collection content. If you connected input elements to a Read & Write mode dataset, when visitors click the 'Next dynamic page' button, their inputs write to the current collection item before loading the next dynamic item page. The same concept applies to the 'Previous dynamic page' click action, which writes to the collection before loading the previous dynamic item page. Learn more about managing collection content from your live site.

Use the dataset 'Download Actions' to allow visitors to click to download specific audio, document, image, or video files from your collection. 

Use the dataset 'Stores/Products Actions' to create buttons that interact with your Wix Stores products. To use these dataset actions, make sure to enable Wix App Collections in your CMS advanced settings. View the available dataset 'Stores/Products Actions' below:

Use the 'Add to cart' action to give visitors a way to add products to their shopping cart from a repeater displaying your products. 

If you have a repeater displaying your Wix Stores products, use the 'Open quick view' action to let visitors view products in the quick view window. From there, visitors can read more about the product and add it to their cart. 

Use the dataset 'PaidPlans/Plans Actions' to create separate buttons visitors can use to select a plan and go to checkout. To use these dataset actions, make sure to enable Wix App Collections in your CMS advanced settings. 

You can connect buttons and images to the following Pricing Plans dataset actions: