Dropdown

Written By Floris de Vries

Last updated 2 days ago

The Dropdown field allows customers to select one option from a predefined list. Each option can have its own numeric value, which can be used directly in price calculations or referenced in later steps of the calculator. Dropdowns are ideal for choices such as materials, finishes, sizes, or service levels.


Label

The Label defines the text displayed above the dropdown on the product page.Use a clear and descriptive label so customers understand what they are selecting.

Example: Material type


Key (unique ID)

The Key is a unique technical identifier for the dropdown field, used internally by the calculator engine.

Important rules:

  • Only lowercase letters are allowed

  • Numbers and underscores are supported

  • No spaces or special characters

Examples: material_type ยท finish_option


Required field

When Required field is enabled, the customer must select an option before the product can be added to the cart.Use this option when the selection is required to calculate the price or complete the order.


Dropdown options

Each dropdown option consists of a Label and a Value (float). Options can be reordered by drag and drop.

Option label

The Option label is the text shown to the customer in the dropdown list.Choose clear, user-friendly names that make the choice easy to understand.

Example: Premium material

Value (float)

The Value (float) is the numeric value associated with the option.This value can be used to:

  • Add a fixed amount to the price

  • Act as a multiplier

  • Be referenced in later calculation steps

Example use cases:

  • 1 for no price change

  • 1.2 as a price multiplier

  • 25 as an additional cost

Default option

You can mark one option as the default. That option is preselected when the product page loads. Leave it unset to start with an empty dropdown that forces the customer to make a choice.

Add / Remove options

  • Use Add to create a new dropdown option

  • Use Remove to delete an existing option

Changes are applied immediately and will be reflected in the calculator logic.


Using the selection in pricing

In the formula builder the dropdown appears in the Form fields dropdown by its label, and using it inserts the numeric value of the selected option into the formula.

Inside Conditional pricing rules you also have access to the position of the selected option (1st, 2nd, 3rdโ€ฆ), so you can write rules that depend on which option was chosen even when several options share the same numeric value.


๐Ÿ’ก Tip:Use dropdowns when customers must choose exactly one option. For multiple selections, use checkboxes instead.