Radio Buttons
Written By Floris de Vries
Last updated 2 days ago
The Radio Buttons field allows customers to select exactly one option from a predefined list. Each option has its own numeric value, which can be used directly in price calculations or referenced in later steps of the calculator. Radio buttons are ideal when all options should be visible at once and a single choice is required.
Label
The Label defines the text displayed above the radio button group on the product page.Use a clear and descriptive label so customers understand what they are choosing.
Example: Delivery method
Key (unique ID)
The Key is a unique technical identifier for the radio button 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: delivery_method ยท print_quality
Required field
When Required field is enabled, the customer must select one option before the product can be added to the cart.Use this option when a choice is mandatory for pricing or order fulfillment.
Radio options
Each radio 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 next to each radio button.Choose short, clear labels so customers can easily compare the available options.
Example: Express delivery
Value (float)
The Value (float) is the numeric value associated with the selected 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.15as a price multiplier20as 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 no selection.
Add / Remove options
Use Add to create a new radio option
Use Remove to delete an existing option
All changes are applied immediately and will be reflected in the calculator logic.
Using the selection in pricing
In the formula builder the field 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 radio buttons when the customer must choose one option and all choices should be visible. If space is limited or the list is long, consider using a dropdown instead.