Checkbox
Written By Floris de Vries
Last updated 3 days ago
The Checkbox field allows customers to enable or disable a single option. It is typically used for optional add-ons, extra services, or confirmations. When selected, the checkbox can apply a numeric value that directly affects the price or can be referenced in later calculation steps.
Label
The Label defines the text displayed next to the checkbox on the product page.
Use a clear and descriptive label so customers understand what they are opting into.
Example:Gift wrapping
Key (unique ID)
The Key is a unique technical identifier for the checkbox field.
It is used internally by the calculator and can be referenced in pricing formulas or conditional logic.
Important rules:
Only lowercase letters are allowed
Numbers and underscores are supported
No spaces or special characters
Examples:gift_wrapexpress_shipping
Required field
When Required field is enabled, the customer must actively choose a state (checked or unchecked) before the product can be added to the cart.
This is useful when a confirmation is required, such as accepting terms or acknowledging conditions.
Default status
The Default status defines whether the checkbox is pre-selected when the product page loads.
Unchecked โ The checkbox is off by default
Checked โ The checkbox is on by default
Choose the default carefully, especially when the checkbox affects pricing.
Numeric value (float)
The Numeric value (float) defines the numeric value applied when the checkbox is checked.
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:
5for a fixed add-on cost1.1as a price multiplier0if the checkbox is only used for logic or conditions
๐ก Tip:
Use checkboxes for optional add-ons. If the customer must choose between multiple mutually exclusive options, use a dropdown or radio buttons instead.