Radio Buttons

Written By Floris de Vries

Last updated 3 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.
It is used by the calculator engine and can be referenced in calculation formulas or conditional logic.

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).

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

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.

💡 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.