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_wrap
express_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:

  • 5 for a fixed add-on cost

  • 1.1 as a price multiplier

  • 0 if 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.