Wix Blocks: Creating and Managing List Type Properties in Widget API

Wix Blocks is open to all Wix Studio users. To get access to Blocks, join Wix Studio.

Sometimes you need a property that can contain a list of items, for example, colors, sizes or locations. The list type can contain a list of items of a single type, such as text strings, numbers, or values of a custom type.

Create a List Type Property

  1. Click the Widget API  icon.
  2. Click Add New Property or hover over Properties and click the  icon.
  3. Give your property a significant name and a display name.
  4. Select List in the Property type menu. 
  5. Select the type of items on the list (or create a new custom type for them).  
  6. Describe your list. 
  7. Click Add items... to add items to your list. 
  8. Click Create. 

Access List Type Properties from a Website

  1. Open the site in the Wix Editor or Wix Studio. 

2.  Select the widget (learn more about installing a widget).

3.  Click Settings in the widget's action bar to see the list. 

Edit List in Blocks Versus in a Site:

  • If you edit list items in Blocks: Changes will come into effect wherever the widget is installed, as long as you make sure to build the app again in Blocks, and refresh the Wix Editor or Wix Studio.
  • If you edit list items in the Editor: Changes will impact only that specific instance of the widget, which is installed in your site.
Did this help?