CMS: About Dataset Click Actions for Buttons and Images
12 min read
In this article
- Editing actions
- Submit
- New
- Revert
- Delete
- List actions
- Load more
- Apply filters
- Reset input values
- Next item / Previous item
- Navigation actions
- Next page / Previous page
- Next dynamic page / Previous dynamic page
- Download actions
- Wix Stores actions
- Add to cart
- Open quick view
- Pricing Plans actions
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.
Editing actions
Use dataset editing actions to create custom CMS forms that are built with input elements that submit to your collection. These actions include 'Submit', 'New', 'Revert', and 'Delete'. View details about each dataset editing action below:
Submit
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.
Notes:
- Set the dataset mode to Write or Read & Write to allow visitors to submit new items or update existing items. If the dataset mode is set to:
- Write: The 'Submit' action adds the input values to a new item in your collection.
- Read & Write: The 'Submit' action updates the input values of the existing colllection item that is retrieved by the dataset.
- Set the collection permissions to Collect content or Advanced to allow visitors to add content to your collection.
New
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.
Notes:
- Set the dataset mode to Write or Read & Write to allow visitors to use 'New' buttons. If the dataset mode is set to:
- Write: Clicking the 'New' button submits the values from the connected input elements as a new item in your collection. The inputs are then cleared so they can accept new values, which you can submit as a new item by clicking 'New' again.
- Read & Write: Clicking the 'New' button submits the values from the connected input elements to update the existing item being read by the dataset. The inputs are then cleared so they can accept new values, which you can submit as a new item by clicking 'New' again.
- Set the collection permissions to Collect content or Advanced to allow visitors to add or update content in your collection.
Revert
Use the 'Revert' action to let visitors click to undo any selections or edits they've made to the input elements. The 'Revert' action resets the values of the dataset's connected input elements that have not yet been submitted to your collection. This is a great way for visitors quickly reset their custom CMS form selections and start over from scratch filling out the form.
Notes:
- Set the dataset mode to Write or Read & Write to allow visitors to use 'Revert' buttons to reset inputs that submit to your collection.
- Set the collection permissions to Collect content or Advanced so the input elements that connect to the same dataset as your 'Revert' button can submit to your collection.
- If you want to give visitors a way to reset input elements that are set to filter content, use the 'Reset input values' action instead.
Delete
Use the 'Delete' click action to delete existing items from the dataset's connected collection. When visitors click the 'Delete' button, the item that is read by the dataset is deleted from your collection.
Notes:
- Set the dataset mode to Read & Write to use this 'Delete' action. The dataset needs to be able to first read the collection item in order to then delete it.
- Set the collection permissions to Advanced and select the Delete checkbox next to the relevant roles.
- You can restore deleted collection items with CMS backups.
List actions
Use dataset list actions to create buttons that interact with other elements that connect to the dataset and read from your collection. These actions include 'Load more', Apply filters', 'Reset input values', 'Next item' and 'Previous item'. View details about each dataset list action below:
Load more
Use the 'Load more' click action to cause the dataset's connected repeater or gallery to load an additional batch of items. The maximum number of items that can load in each batch is determined by the 'Items per load' dataset setting. This setting also controls the maximum number of items that initially load in the dataset's connected repeater or gallery.
For example:
Imagine having a repeater connected to a dataset with the 'Items per load' setting set to 4 and the collection containing 10 items. When the page loads, the dataset can only read 4 items per load, so only 4 items initially appear in the repeater. When a visitor clicks a 'Load more' button, the next 4 collection items are read and displayed for a total of 8 items (4+4=8). Clicking 'Load more' again causes the dataset to look for 4 more items. The collection only has 2 more items, so the remaining 2 items load to display all 10 items (4+4+2=10).
Other dataset settings, such as filters and sorts, also apply to the 'Load more' action. So, if you add a filter to exclude items, the dataset does not read these items or display them when visitors click your 'Load more' button. Dataset sort conditions determine the order in which the items load initially, and when visitors click the 'Load more' button.
Notes:
- Set the dataset mode to Read or Read & Write to use the 'Load more' click action. The dataset needs to be able to read your collection in order to display its items.
- You can set the collection permissions to Show content, Collect content, or Advanced. Whichever you choose, make sure to set the 'View' permissions so only the appropriate visitors can view the collection content on your live site.
- The 'Load more' action is only relevant to datasets that connect to repeaters or galleries.
FAQs about the 'Load more' action:
What is the maximum number of items I can load at a time?
Why should I add 'Load more' or 'Previous/Next page' buttons?
How do I create a 'Load more' button?
Why doesn't my pro gallery's 'Load more' button respond to the dataset settings?
Apply filters
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.
Note:
This click action is only available when the dataset mode is set to Read or Read & Write.
Reset input values
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.
Notes:
- This click action is only available when the dataset mode is set to Read or Read & Write.
- If you need to reset values in input elements that are set to collect submissions, use the 'Revert' click action instead.
Next item / Previous item
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.
Notes:
- These actions are only available when the dataset mode is set to Read or Read & Write.
- These actions are not relevant for buttons or images connected to dynamic datasets:
- On dynamic item pages: Use the 'Next/Previous dynamic page' action instead, if you want to take visitors to the next/previous item's version of the page.
- On dynamic list pages: Use the 'Next/Previous page' action instead, if you want the connected repeater or gallery to show the next set or 'page' of items. The Items per load field in the dataset settings determines how many items can appear in each 'page' of items.
- To use click actions to cycle through items displayed in a repeater or gallery on a regular page, use the 'Next/Previous page' action instead.
Navigation actions
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:
Next page / Previous page
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.
Notes:
- These click actions are only available when the dataset mode is set to Read or Read & Write.
- These actions are only relevant to datasets connected to repeaters and galleries.
- These actions are not relevant for dynamic item page datasets used to show only 1 item on the page. Instead, use the 'Next/Previous dynamic page' action to take visitors to the next or previous item's version (dynamic URL) of the page.
Next dynamic page / Previous dynamic page
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.
Note:
- These click actions are only available when the dataset mode is set to Read or Read & Write.
- These click actions work with buttons and images on dynamic item pages only. The button or image must be connected to the dynamic item page's connected dataset.
Download actions
Use the dataset 'Download Actions' to allow visitors to click to download specific audio, document, image, or video files from your collection.
Wix Stores actions
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:
View full tutorials about:
Add to cart
Use the 'Add to cart' action to give visitors a way to add products to their shopping cart from a repeater displaying your products.
Note:
This click action is available if you have Wix App Collections enabled, Wix Stores products, and the dataset connects to the Products Wix App collection.
Open quick view
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.
Note:
This click action is available if you have Wix App Collections enabled, Wix Stores products, and the dataset connects to the Products Wix App collection.
Pricing Plans actions
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:
- Select plan: When clicked, this action adds the relevant plan to the cart.
- Navigate to checkout: When clicked, this action takes the visitor to checkout.
Note:
This click action is available if you have Wix App Collections enabled, plans created in Wix Pricing Plans, and the dataset connects to the Plans Wix App collection.
