Wix Blocks: Widget API Functions

Wix Blocks is currently open to a limited number of users.

Add a new function to enable site creators to perform actions related to the widgets on their websites. For example, a site creator who has a shopping widget would like to be able to get the address of a certain customer through the function getAddress(customerId) and set the address through the function setAddress(customerId).

To add a new public function to your widget:

1.  Click the Widget API  icon.

2.  Click Add New Public Function or hover over Functions and click the  icon. 

add new public function

3.  Add the code for your function in the code panel, where a new function "foo" appears. 

4.  Change the new default name to a meaningful name and edit the function.

Copy Code
import {getJSON} from 'wix-fetch';
*@description Add item to cart
*@param {string} productId - The Id of the product to add to the cart
*@param {number} quantity - How many products to add
*@returns {Promise<boolean>} True on success, false on error
export async function addItemToCart(productId, quantity){
try {
const addToCartReponse = await getJSON('https://myCustomStoreService/cart', {
method: 'POST',
body: JSON.stringify({
return addToCartReponse.success
} catch (e) {
return false

Don't forget to document When you write your function, make sure to replace the automatic jsdoc that appears above it with your own one. The user of the widget will see the jsdoc when using the function in a site.

Next Step: Using the Widget API on a Site

Learn more about using your Widget API when editing a site.

Learn more about your widget API:

About your widget API

Widget API properties

Widget API events

Want to learn more about Blocks? Check out the Wix Blocks help articles

Was this helpful?