Skip to content

Fields ​

Fields are the inputs that the customer fills in on the product page.

Edit a field

Click Add field to add one. Each field has:

  • Label: the text the customer sees.
  • Name in formulas: how you use the field in formulas, between brackets. A field named width is [width] in a formula. The name is made from the label; you can change it. Use lowercase letters, digits and underscores, starting with a letter (at most 40 characters).
  • Type: see below.
  • Required: the customer must fill it in before adding to cart (not for checkboxes, switches, sliders, color pickers, dynamic variables and information text).

The names quantity, product_price, product_weight and changed are reserved.

In the list, use the arrows to change the order, the switch in the Shown column to hide a field from the product page, the pencil to edit and the bin to delete.

A product can have up to 100 fields.

Field types ​

TypeWhat the customer seesValue in a formula
NumberA number box. Optional minimum, maximum, step and unit (for example cm).The number
DropdownA list of options.The value of the selected option
Radio buttonsA list of options, one can be chosen.The value of the selected option
CheckboxA box to tick.1 when ticked, 0 when not
SwitchAn on/off switch.1 when on, 0 when off
TextA one-line text box. Optional placeholder, minimum and maximum length.The text (use quotes)
Text areaA multi-line text box.The text (use quotes)
SliderA slider with a number box. Minimum, maximum and step are required.The number
DateA date picker. Optional earliest and latest day, in days from today.The date as DD/MM/YYYY (use quotes)
Color pickerA color picker.The color as #rrggbb (use quotes)
Dynamic variableRead-only text: label and value.The number
Information textText or HTML that you write.No value

Options ​

Dropdown and Radio buttons fields have options. Each option has a Label (shown to the customer) and a Value (used in formulas). Tick Default for the option selected when the page opens.

Example: a color field with these options:

LabelValue
Oak0
Clear5
Dark10

If the customer selects Dark, [color] * 2 gives 10 * 2.

Option values can be numbers or text. If one value is text, write the field in quotes in formulas: "[color]". Values can't contain quotes, backslashes or square brackets. A field can have up to 200 options.

Dynamic variable ​

A Dynamic variable holds a value that the app calculates. The customer can't edit it. The product page shows its label and its current value, with its unit.

Set its value with a field formula, then use it in the price formula like any other field.

An interval or a grid can also set it, but only for the price: the product page keeps showing the default value.

Example: an area field with the field formula [area] = [width] * [height] / 10000 shows the area to the customer.

Information text ​

Shows text on the product page, for example a size guide. HTML is allowed: bold, italic, links, lists, headings, line breaks, images and tables. Scripts and styles are removed. The label is only used in the app. This text is not added to the cart and can't be used in formulas.

Rename and delete ​

When you rename a field, the app changes its name in the formulas, conditions and other places that use it. Check before saving.

A field that is used in a formula, condition, field formula, interval or grid can't be deleted. Remove it from there first.

In the cart ​

The customer's choices are added to the cart line, so you see them in the cart, checkout and order. Unticked checkboxes, switches that are off, empty text fields and information text are left out.