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:
1for no price change1.2as a price multiplier25as 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.