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:

  • 1 for no price change

  • 1.15 as a price multiplier

  • 20 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 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.