CMS: About Dataset Click Actions for Buttons and Images
7 min read
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 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:
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:
- This action is only available when the dataset mode is set to Write or Read & Write.
- If the dataset mode is Write, this action submits the inputs as a new item.
- If the dataset mode is Read & Write, this action updates the displayed item.
New
Use the 'New' click action to create a new item in the dataset's connected collection.
If you connected input elements to a Read & Write mode dataset, when visitors click the 'New' button, their inputs write to the current collection item before creating a new item. The inputs are then reset so visitors can start from scratch and enter new values or make new selections in the input elements. Learn more about managing collection content from your live site.
Note:
This click action is only available when the dataset mode is set to Write or Read & Write.
Revert
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.
Note:
This click action is only available when the dataset mode is set to Write or Read & Write.
Delete
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.
Notes:
- This click action is only available when the dataset mode is set to Write or Read & Write.
- You can restore deleted collection items with CMS backups.
List actions
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:
Load more
Use the 'Load more' click action to load additional items in the dataset's connected repeater or gallery. The Maximum items displayed 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.
Notes:
- This action is only available when the dataset mode is set to Read or Read & Write.
- This action is only relevant for repeaters and galleries.
- This action does not change the number of items that load per page in the 'Next/Previous page' actions. The items per page is based on the dataset's Maximum items displayed 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 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. On dynamic list pages in the Wix Editor, we recommend adding pagination bar if you want visitors to cycle through 'pages' of the listed 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 connected dataset's Maximum items displayed field determines how many items are on each 'page'. The dataset's filters and sort conditions also 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 Maximum items displayed 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 available on regular datasets, not dynamic page datasets.
- These actions are only relevant to datasets connected to repeaters and galleries.
Next dynamic page / Previous dynamic page
On a dynamic item page, the 'Next/previous dynamic page' click actions take you to the next or previous item's dynamic page URL from the dataset's connected collection. When the 'Next/Previous item' actions are clicked, the dataset's filters and sort conditions determine which item's page loads.
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.
Did this help?
|